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We're Talking Major 
Flexibility Here 

Greenleaf can control, store, compress, Windowize, and organize your data. 
That's just the beginning: read more about the products that do it... 



Greenleaf 
ArchiveLib 



Supports Windows 3.1, MS-DOS, and can be ported to 
OS/2 and UNIX. 

No more spawning calls to data compression 
programs from within your application: all you do is 
call ArchiveLib functions from your C or C++ 
application. 

You hold the reins for managing what is compressed 
or expanded, in what order, where it is placed, how it 
is retrieved, etc. 

Lets you specify the source and destination for any 
media (file, buffer, serial stream, parallel port, etc.) 

Windows 3.1 DLL and static link libraries included 
(DLL is linkable with most DLL-capable compilers 
including Visual Basic). 

Supports Borland, Microsoft, Symantec, TopSpeed, 
Visual C++ and WATCOM C/C++ compilers. 

BUILD utility will rebuild the library for your specific 
compiler. 

What about the competition? Here's how ArchiveLib 
stacks up: 

The competition's data compression package contains 
two functions; ArchiveLib contains over 4 classes and 
100 functions (for C and C++ programmers). 

The competition simply compresses data; ArchiveLib 
compresses ASCII or binary data and archives it. 



Greenleaf 
Database Library 



functions access industry standard 
index, and memo files at an affordable 



/ Supports Windows 3.1, MS-DOS, and can be ported to 
OS/2 and UNIX. 

/ Over 150 C 
database data 
price. 

/ Windows 3.1 DLL and static link libraries included 
(DLL is linkable with most DLL-capable compilers 
including Visual Basic). 

/ Unsurpassed speed and flexibility let you interface 
with dBASE III, dBASE IV, FoxPro, FoxBASE, Clipper, 
dBXL, and other xBASE files including new FoxPro 
CDX index files. 

/ Does not require any database package: product is a 
complete ISAM library. 

</ Lets you use index and / or memo file types other than 
the ones associated with your database. 

/ Unlimited number of record and file locks available, 
make it fully compatible with multiuser and network 
applications. 

</ Single and multiple user network access fully 
supported. 

/ Supports Borland, Microsoft, Symantec, TopSpeed, 
Visual C++ and WATCOM C/C++ compilers. 

/ BUILD utility will rebuild the library for your specific 
compiler. 



Greenleaf ArchiveLib v1 .0 
Greenleaf Database Library v3.22 



$279 
$249 



□ FREE Source code-all of it! 

□ FREE Unlimited Tech Support. 

□ FREE online Windows and DOS help system. 

□ Compilable examples available in three places: online help, 
Reference Manual, and on disk 

□ FREE access to Greenleaf BBS. 

□ Professional quality, same day shipment, personalized 
service. 

□ Greenleaf Gold Support is also available— ask about it! 

□ 60-day money-back guaranty (if source code not opened). 



Call Greenleaf Software today for complete information 
or to order. Major credit cards, COD, approved purchase 
orders. Same day shipment in most cases. 

(800)523-9830 

(214)248-2561 FAX: (214)248-7830 
BBS: (214)250-3778 for free information. 
16479 Dallas Parkway, Suite 570, Dallas, TX 75248 
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Can't WaifTo See In UNIX. 



Do Windows Without 
Getting Soaked! 

It's an eyeopener! The multi- 
user, multi-tasking power of UNIX 
in Coherent with X- Windows. It's 
the GUI everyone's looking for. 
Multiple overlapping windows. 
Graphic color. And the price? 
You won't believe your eyes! 

But Coherent was 
independently developed by Mark 
Williams Company as a virtual 
clone of UNIX. So it comes with a 
very un-UNIX-like price. 
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Software Critics And 
Over 60,000 Users 
Say it All! 

Coherent has been hailed as 
possibly the best thing that ever 
happened to UNIX. And with 
tens of thousands of users, the 
critics are still marveling. 




Run The World's 
Best Selling Software! 

Coherent now runs 

WordPerfect, 
Lotus 1-2-3 and 
most every other 
UNIX PC 
application 
right out of the 
box. Call for 
current 
information. 
Whatever the 
software, 
chances are Coherent runs it now! 



Coherent With 
X-Windows 



Coii'l"' U 



"To paraphrase Annie Oakley, 
•Anything U(NIX) can do. 
Coherent can do better wpu ting 
-Michele Petrwsky, LAN Ooiw 





$149.95 

(Without X-Windows, $99.95) 



Small Is Beautiful 
In So Many Ways. 

Coherent embraces the original 
UNIX philosophy: Small is 
beautiful. Small price, obviously. 
But Coherent has other size 
advantages as well. 

Its 5-disk installation is a 
breeze. Just plug and play. No need 
for CD-ROM drives or special device 
adapters. And Coherent can reside 
with DOS so you can keep all your 
DOS windows applications, too. 




Don't Let 

The Price Fool You 

This is no stripped down UNIX 
wannabe. Coherent is a fully 
professional multi-user system with 
a complete C compiler, assembler 
and over 200 powerful UNIX 
commands for development, 
administration, maintenance and text 
processing. You could pay thousands 
for all this. Plus you get our 
acclaimed 1200-page manual. 



You Simply 
Can't Go Wrong. 

Mark Williams Company has 
been developing professional 
programming products since 1976. 
Our free unlimited technical support 
along with our popular BBS are 
renowned. We ship most orders 
within 24 hours, which means you'll 
have the power of Coherent in your 
hands in no time. And 
with our extended 
money-back 
guarantee, you 
can't miss. 

So pick up 
the phone and 
order Coherent 
4.2 with X-Windows today. And get 
everything you can't wait to see. 



Mark Williams Company 

60 Revere Drive 
Northbrook, IL 60062 





Order Now! 1-800-636-6700 

or 708-291-6700, FAX: 708-291-6750 

Coherent is a trademark of Mark Williams Company. UNIX is a trademark of USL. All other product and company names mentioned are trademarks or registered trademarks of their respective companies. 

Distributors: Australia + 07-266-2270, Brazil + 01 1-883-2299, Czech. + 06-32-62877, France +1-4741-4519, + 1-4672-8074, Germany + 051 1-53-7295, Greece + (01) 222-351 1, 
Holland + 2240-18499, Hungary + 153-0988, Malaysia + 03-756-4477,Venezuela/Caribbean + 1-809-723-5000, Sweden + 06-60-19290, UK + (0) 81-541-5466 



Componen 



Visual C++ 1.5 



Component Number 



Proper Name 





C++ IKS 




THE BUILDING 
BLOCKS OF VISUAL 
DEVELOPMENT. 



The elements of next genera- 
tion applications are found in the 
components of the Microsoft" 
Visual C++ " development system, 
version 1.5 today. 

Innovative wizard technology 
allows you to seamlessly meld 
components into sophisticated appli- 
cations, in weeks not months. Just 
remember this simple equation: 
MFC 2.5, OLE 2.0, ODBC. 

That's a perfect formula for 
building and reusing components. 
At the nucleus is MFC 2.5 
(Microsoft Foundation Class Libra- 
ries), the standard API for Windows." 
The new OLE (Object Linking 
and Embedding) classes make it 
easier than ever to implement OLE's 
unprecedented integration power, 
new drag-and-drop features, visual 
editing and OLE automation. 
In all, it provides more than 19,000 
lines of code you want, but won't 
have to write or rewrite. 

In addition, the new ODBC 
(Open Database Connectivity) 



classes provide access to major 
databases and data binding without 
coding. It's a powerful new plat- 
form for creating high-performance 
database applications. 

Best of all, your 16-bit MFC 
applications are portable to the 
Windows NT " operating system and 
future versions of Windows. Now 
that's good chemistry. 

If you want the latest tools for 
the latest Windows technology, ask 
for Mcrosoft Visual C++ 1.5. 

Call us now at (800) 434-3980 
and we'll make you a catalyst for 
change today and into the future 
of Windows operating systems. 




New 16-bit version 1.5 joins the Visual C++ 
family of development systems for Windows 
and Windows NT. 



Microsoft 



© 1993 Microsoft Corporation. All rights reserved. In the 50 United Stares, call (800) 434-3980; customers in Canada, call (800) 563-9048; outside the U.S. 
and Canada, call your local Microsoft subsidiary or (206) 9.16-8661. Microsoft is a registered trademark and Visual C++, Windows and Windows NT are 
trademarks of Microsoft Corporation. 




REAL-TIME/EMBEDDED SYSTEMS 



Symbolic Access to Embedded Controllers 

By Odd A. S. Olsen and Petter H. Heyerdahl 21 

The principle of deferred binding even applies to embedded systems sometimes. 

An Embedded System EXE Locator 

By Charles B. Allison 35 

Here's an important missing ingredient in turning your PC compiler into a development platform for embed- 
ded systems. 

A Fuzzy-Logic Torque Servo 

By Jack J. McCauley 47 

Intrigued by the promise of fuzzy logic? Here's a simple real-world application that shows how the promise 
can pay off. 



FEATURES 



Weight Reduction Techniques in C++ 

By Randy Kamradt 70 

Nobody ever said that object-oriented programming gives you something for nothing. But with a little old- 
fashioned tuning, you can get that something and keep good performance in the bargain. 

Enhancing the UNIX Korn Shell Using Predictor Techniques 

By Philip Thomas and Shmuel Rotenstreich 83 

If you like a shell that keeps a command history, you'll love one that predicts the future as well. 

BOOK REVIEW 



C Elements of Style Reviewed by Dw ay ne Phillips 115 



Cover Photo by Steve Dunwell © 1987 Steve Dunwell/The Image Bank 
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P. J. Plauger 10 

Questions & Answers: Run-Time Type Checking in C++ 

Kenneth Pugh 65 

Stepping Up to C++: The Return Types of Virtual Functions 

Dan Saks 91 

Code Capsules: The Preprocessor 
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IOCCC, ASXXXX, MINED, TDE Update, and a Bug Fix 

Victor R. Volkman 117 
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CUJ Online Source Code 

You can obtain all code published (and some unpublished) in CUJ from: 

USENET (Archived by UUNET Technologies): 
uunet!~/pubhshed/cuj/19YY/monYY.tar.Z 

Available via anonymous FTP from ftp. uu. net or via uucp from (900)GOT-SRCS. 

Download via uucp and uncompress using compress -d fi lename, then tar xvf fi lename to expand the 
archive. 

BBS: 

Cornerstone, 206-362-4283; The Courts of Chaos, 501-985-0059; EmmaSoft Shareware Board, 607-533- 
7072; Phoenix Chapter ACM Library, 602-970-0474; The Programmer's Corner, 301-596-7692; The 
Brass Cannon, 801-226-8310. 

CompuServe: 

In Library 7, CLMFORUM 

GEnie: 

In the IBM-PC Roundtable at page 615 (Keyword: D3MPC). 
Monthly Code Disk: 

Call R&D Publications, Customer Relations, (913) 841-1631. 
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ZINC™ APPLICATION FRAMEWORK™ 3.5 

Multiplaf f orm Flexibility 
From One Application 
Framework. 



FLEXIBILITY 



is an essential component in software design. Your 
development tools should allow you to easily incorporate new 
features and technologies into your applications without rewriting 
all of your code. That's a tall order if your development tools are 
designed like a straight-jacket. Zinc Application Framework 3.5 
and Zinc Designer™ give you flexible and extendible support for 
Microsoft Windows, Windows NT, OS/2 2.0, UNIX Motif DOS 
Graphics and DOS Text. And Zinc does it with ONE set of source 
code. Zinc's multiplatf orm, object-oriented architecture won't 

confine your application development options today... or tomorrow. 



FOR A FREE ZINC DEMO KIT, CALL US TOLL FREE TODAY AT 
1.800.638.8665. IN EUROPE CALL +44 (0)81 855 9918 



n 



ZINC SOFTWARE INCORPORATED, 405 SOUTH 100 EAST, 2ND FLOOR, PLEASANT GROVE, 
UTAH 84062, TEL 80 I . 7 85 . 8900, FAX 80 1 . 785 . 8996. BBS 80 I . 785 . 8997. 

EUROPE: ZINC SONWARt (UK) LIMITED 56-60 BE RESFOR D STREET, LONDON SE I 8 6BG, 
TEL +44 (0) 81 855 9918, FAX +44 (0) 81 3/6 7778, BBS +44 (0) 81 3/7 2310 

<D COPYRIGHT 1992 ZINC SOFTWARE INCORPORATED. ALL RIGHTS RESERVED ZINC. ZINC 
DESIGNER AND ZINC APPLICATION FRAMEWORK ARE TRADEMARKS OF ZINC SOFTWARE 
INCORPORATED. OTHER TRADEMARKS ARE OWNED BY THEIR RESPECTIVE COMPANIES 
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Overwrites •JA, 



New 

VERSION 

3.0 



Introducing MemCheck 3.0 for DOS 

With this major new release, MemCheck once again establishes itself as the number one 
defense against the worst bugs in C. MemCheck 3.0 is a quantum leap in bug-stomping 
power and is super-tuned for blazing speed that just plain leaves its competition in the 
dust. MemCheck 3.0 now detects errors in every part of your application, even in third- 
party libraries for which you don't have the source code! And unlike other tools that try to do some or the same 
checking, MemCheck works perfectly with your favorite debugger, and can even be used to find problems at 
your customers' sites! 

Find hidden bugs 

You know how hard it is to write the perfect C program. Leave one little detail out of place, and you'll spend 
hours, days, or even weeks looking for what went wrong. Errors can be as simple as forgetting to free allocated 
memory, or as elusive as overwriting the end of a block by a single byte. So if you're serious about writing rock- 
solid applications, get MemCheck the fastest, easiest defense against a whole cadre of memory bugs. 

Engineered for ease of use 

Best of all, whatever platform you use it on, MemCheck does its work silendy and automatically. You'll get 
concise, informative messages that pinpoint what's wrong, usually with the exact source file and line number. 

Like unfreed memory, or overwritten buffers. Null pointer assignments, invalid calls tofreeQ, destruaive strcpy()% 
memcpyQs, and more. With its automatic operation and low profile, MemCheck will prove to be one of the 
most valuable took in your development arsenal. 



MemCheck 3.0 for DOS Highlights: 

o Detects errors in third party libraries without 
source code or debugging information! 

o Seamless C++ new and delete coverage! 

o Effortlessly pinpoints memory overwrites, 

underwrites, memory leakage, invalid frees, null 
pointer assignments, stack frame overwrites, 
heap corruption, and other app ills 

o Link-only option requires absolutely no source 
changes! 

o Absolutely blazing performance - from 
almost 10 to over 50 times faster than similar 
products! 

o Enhanced stack/static/global variable 
overwrite checking — automatically! 

o Works transparently with any debugger! 
(TurboDebugger, CodeView, WVIDEO, etc.) 

o Can debug problems at customer sites! 

o Powerful debugging API 

o Mouse-driven, user-friendly MemCheck Settings 
application for easy control over MemCheck 3.0 



RATINGS (OPERATIONS / 8«C) 



MEMCHECK PRICING 

Be sure to specify compiler and platform 
when ordering 

MEMCHECK 3.0 FOR DOS $139 

Specify Microsoft C, Borland C, or Watcom C 
(Upgrade from MemCheck 2.1 S79) 

MEMCHECK 2.1 FOR WINDOWS H*9 $99 

Specify Microsoft C or Borland C 

MEMCHECK 2. 1 FOR THE MAC $1 79 $99 

Specify Think CorMPWC 

► NEW. 1 MEMCHECK 2.1 / ANSI $199 

Includes source code! For any UNIX, VAX, or 
any ANSI C or K & R projects 



SPECIAL BUNDLES! 

DOS MASTERS PACK $199 SAVE $BO! 

for Microsoft C and Borland C 
WINDOWS GURU PACK $159 

for Microsoft C and Borland C 

MICBOSOFT POWER PACK SttPP 

for Microsoft C under DOS and Windows 
BORLAND POWER PACK $199 

for Borland C/C++ under DOS and Windows 



Order Today! 

Developing quality software is a challenge for even the best 
programmers. And you have far better things to do than wonder if 
the same bugs will rob you of productivity, profit, and reputation. 
So we invite you to join us as a valued customer, and to join the 
thousands of professional developers all over the world who use 
MemCheck. Call now 1-800-933-3284 ( 1 -800- WE- 
DEBUG) to start stomping your worst C bugs! You'll be glad you 
did — we guarantee it with an unconditional 30-day money-back 
One can turn the other cheek only so many rimes... 




MemCheck 3.0 

ahcOtiW-IW. checker 
Generic heap checker 




"MemCheck is worth its weight in gold" 

— David Thielen, author of "NO BUGS: Delivering 
Error-Free Code in C and C++ " 

FREE BONUS! 

ViruCide 3.0 Anti-Virus Software 
A $70 value with every purchase! 

(while supplies List) 

1-800- 
WE-DEBUG 

StratosWare Corporation 

1756 Plymouth Road, Suite 1500 * Ann Arbor. Ml • 
48105-1890 * 1-800-WE-DEBUG • Internationa/ 

(313)996-2944 • Fax Linn (313) 996-2955 & (313) 
747-8519 • CompuServe 70244,1372 

WE USE AND SHIP QUALITY 
RECYCLED MATERIALS. 
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Cobol 

Clipper 

dBASE 



From DOS. 




>■ Complete graphical interfaces for your DOS 
programs: data entry screens, windows, 
help systems, icons, menus. . . 

*- Powerful interactive design tools let you 
create re-usable interface objects in a snap! 

>- The proven user interface solution for 
thousands of developers since 1 986! 



...to Windows 



Query Wit- Be P«< Utlp 




>■ Just recompile, and see your screens and 
menus run under Windows. It's that easy! 

>■ Single code base portable across DOS and 
Windows. 



1-800-338-2852 

SOFT WAY 

Tel: (415) 896-0708 Fax:(415) 896-0709 
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Editor's Forum 




Well, I made it past my 50th birthday. Being a 50-year-old computer programmer is 
definitely better than being 20 — you get more toys to play with and more autonomy in 
choosing what to do with them. But I confess that it's not as nice as being 30, or even 40 
— I miss the energy that came with those relatively youthful milestones. My main conso- 
lation is that I still have some energy left, and I'm much wiser about how I spend it now 
than in years gone by. 

I couldn't help but notice at 30 that many of my 40-year-old colleagues weren't as 
active in the trenches as I was. Ten years later, I found out why. With maturity in one's 
profession comes increasing demands to serve as caretaker rather than front-line contribu- 
tor. Someone has to write all those proposals, job descriptions, requirements documents, 
requisitions, etc. They eat time like candy and sure don't resemble programming. But only 
the most dedicated techies can resist the siren lure of responsibility. The rest of us get 
suckered into acting like grownups. 

I couldn't help but notice at 40 that many of my 50-year-old colleagues weren't even 
fighting interesting battles, or so it appeared to me at the time. They seemed to attend 
interminable meetings and talk about policy matters and other ephemeral abstractions. I 
mean, how important can it be to draft international standards, or procedures for software 
quality control, for heaven's sake? Now, after a decade or more of doing that sort of stuff, 
I've come to see the merit in it. I've learned how to play the guru, or the statesman, or the 
doddering old fool, as the need arises. I can even sit through a two-hour meeting without 
squirming (excessively). 

I still write the odd bit of code, or the odd requirements spec, and it's more fun than 
ever. I spent the half-week before my birthday in New Jersey, beating on the draft C++ 
standard with Andy Koenig, Tom Plum, Bjarne Stroustrup, and others — and I have to 
admit it was mostly enjoyable. The computer business has never been more exciting than 
it is today. I have much to be grateful for. 

When I stumbled into this field at the age of 19, I never dreamed it would consume 
my entire adult career. Or that it would bring me so many rewards. I can only hope that 
most of you who read this magazine can enjoy a comparable passion. May your candle 
burn equally bright. 

So how does it feel to be half a century old? My favorite quote on that topic is from 
Lowell Thomas, who was asked on his birthday how it felt to be 80. He said, "It's not 
bad, considering the alternative." 



P.J. Plauger 
pjp@plauger.com 
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Tools.h++ Version 6.0 
Now Internationalized! 



Tools. h++ the best selling 
industry standard C++ 
library, now includes 
Internationalization! A 
complete, efficient and versatils 
toolbox of over 100 C++ classes 
Tools.h++ will make virtually 
any programming job easier. 
And now new Version 6.0 
includes: 

Internationalization 

• Multi-byte and wide 
character strings 
Localized string collation 
Parse and format times, dates, 
and currency in multiple locales 
Support for multiple time zones 
and daylight savings rules 
Support for localized messages 
Localized I/O streams 
Many locales can be active 
simultaneously 

Multi Thread safe 

Safe for use in multi thread environments 
Support for task specific data 

Exception 

Comprehensive exception hierarchy 
Exception handlers can report in 
the local language 

Comprehensive test suites are now available! 

• ToolsPro.h++ includes a complete test suite for 
all classes 

Now you can create one executable 
and ship it to multiple countries! 
Tools. h++ lets you read and print times, 
dates, numbers, and currency 
in the local format and language! 



Includes template and non-template classes! 
You choose! 



Now also available on 
WINDOWS NT ana* Macintosh 




Tools.h++ is a complete, 
efficient and versatile 
toolbox of over 
100 C++ classes: 

• String and Character manipulation 
classes. 

• Singly and Doubly linked lists, Stacks, 
Queues and Vectors classes. 

• Smalltalk"'-like Collection classes: 
Set, Bag, SortedCollection, Ordered 
Collection, Dictionary, Stack Queue, etc. 

• Regular Expression Class for search 
and replace. 

• Tokenizer Class for easy string parsing. 

• File Class to handle file manipulation 
with read, write, seek, erase, etc. 

• B-tree Class to handle efficient keyed 
access of disk records. 

• File Space Manager Class to allocate, 
deallocate and coalesce space within 
files. 



Virtual and Buffered Page 
Heap to manage objects bigger 
than 64k. 
• All objects fully persistent. 

Rogue Wave's Tools.h++ 
"industrial 
strength" library 
used in many 
commercial 
applications, small 
and large. All 
classes have not 
been derived from 
a single root object, 
so they can be 
easily integrated 
with other class 
libraries. 

Tools.h++ is an excellent example 
of how to write true C++ code 
correctly. Source Code is 
included. All non-Windows 
classes are strictly portable 
between DOS and UNIX. 

Other Rogue Wave 
Libraries Include: 

View.h++ 

A complete C++ encapsulation of the 
industry standard OSF/Motif tool kit. 

LAPACK.h++ and Math.h++ 

High level math libraries. 

DB.h++ 

A portable C++ 
database interface 
for RDBMS's. 



PURIFY'd 



Our libraries work 
with most of the C++ 
compilers on the 
market today. 




ROGUE 
WAVE 

SOFTWARE 
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C++ Language Support Library 



Introduction 

I conclude my discussion of the language support portion of 
the library specified by the draft C++ standard. (See "Standard C: 
The Header <exception>" CUJ, February 1994, "The C Library 
in C++," CUJ, December 1993, "C++ Library Ground Rules," 
CUJ, November 1993, and "Developing the Standard C++ Li- 
brary," CUJ, October 1993.) 

"Language support" consists of those 
functions that can be called implicitly by 
C++ code, even when the code appar- 
ently contains no function calls. It also 
consists of the types required to declare 
and use those functions, as well as a few 
other related functions and types not di- 
rectly needed to support the C++ lan- 
guage proper. 

Standard C has few such creatures (if 
any). You can argue that several type 
definitions are part of language support. 
The types ptrdiff_t, size_t, and 
wchar_t are defined in various headers 
so you can declare objects that have the 
same types as certain expressions. They 
are a way to convey otherwise unknow- 
able (or hard to learn) information about 
these types from the translator to the 
program. 

You can also argue that function exit 
is part of language support. The execu- 
tion of any C program effectively occurs 
by evaluating the expression 
exit(main(argc, argv)). Saying such a 
thing simplifies descriptions — it ties to- 
gether the effects of calling exit and re- 
turning from main, for example. But it doesn't have a dramatic 
effect on how you actually write C programs. You cannot, for 
example, provide your own version of exit and expect it to be 
called when main returns. (And many implementations don't really 
call exit when main returns, but some other underlying function 
instead.) 




C++, on the other hand, offers numerous opportunities along 
these lines. You can trot up all sorts of functions that get control, 
either directly or indirectly, when one of the language support 
functions gets called. For example, in last month's discussion of 
exceptions I identified three functions that let you register han- 
dlers, or functions that get control under some circumstances: 
• set_termi nate, to specify a handler for calls to terminateO 

set_unexpected, to specify a handler 
for calls to unexpected ( ) 
• xmsg: :set_raise_handler, to specify 

a handler for calls to xmsg: :raise() 
You can also derive a class from xmsg 
and override the virtual xmsg: :do_raise 
to get control when certain exceptions 
get reported by executing code. 

Thus, the draft C++ standard is a bit 
harder to write than the C Standard. In 
C, the implementation provides all li- 
brary functions and you the programmer 
cannot displace them. The C Standard 
only has to describe a single interface 
between implementation and program. In 
C++, however, the program can displace 
functions otherwise supplied by the li- 
brary. The draft C++ standard must spell 
out the environment promised to such a 
displacing function. And it must spell 
out what is expected of the displacing 
function so the program doesn't get sur- 
prised. 

A handler for terminateO, for exam- 
ple, is not supposed to return to its 
caller. If you provide one that prints a 
message and returns, you can cause the 
library severe problems. The draft C++ standard says so. So when 
you read the descriptions that follow, remember that the "treaty" 
between programmer and implementor can be multifaceted. The 
extra complexity of the draft C++ standard is one of the prices we 
pay for extra flexibility in this area. 



P.J. Plauger is senior editor of The C Users Journal. He is convenor of the ISO C standards committee, WG14, and active on the 
C++ committee, WG21. His latest books are The Standard C Library, and Programming on Purpose (three volumes), all published 
by Prentice-Hall. You can reach him at pjp@p1auger.com. 
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C++ essentially structure the use of ma 1 loc and free. By writing: 
Thing *p = new Thing; 

you are assured that the object of type Thing is properly con- 
structed after it is successfully allocated and before it can be ac- 
cessed through p. Similarly, the expression statement: 

delete p; 

ensures that the object is destroyed before its storage is deallo- 
cated. 

You don't have to include any headers before writing expres- 
sions like these — new and delete are indeed built right into the 
language. But you can also play a variety of games with storage 
allocation if you choose. To do so, you begin by including the 
header <new>. Listing 1 shows a representative version of this 
header. I omit the extra superstructure required by namespaces, 
because it is distracting and still in a state of flux. 

The simplest game you can play is to gain control when space 
for the heap is exhausted. The function set_new_handler lets you 
register a handler for this condition. In principle, the draft C++ 
standard says you can "make more storage available for allocation 
and then return," but it fails to describe a portable way to do so. 
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output medium (DOS) "* Statistical and smoothing functions 
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plots, staircase plots type fonts in Graphic for only $59 

Graphic is a C-library that allows you to create every sort 
of scientific and engineering plot. No special knowledge 
is required to program in GUI environments. 

Scientific Endeavors Corporation 

508 N. Kentucky St., Kingston, TN 37763 
(800) 998-1571 FAX: (615) 376-1571 
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guaranteed. More likely, you will want to throw an exception or 
terminate execution at this point. 

xall oc Exceptions 

The default "new handler" does, in fact, throw an exception 
now. As I described last month, all library exceptions are derived 
from the base class xmsg. Moreover, all exceptions are thrown by 
calling ex.raiseO, for some object ex of class xmsg. Unless you 
seize control of the process in one of the ways I described last 
month, the eventual outcome is that a failed allocation will throw 
an exception, which will in turn terminate execution of the pro- 
gram. 

This is a significant change from universal past practice, which 
has been to quietly yield a null pointer as a result of the new ex- 
pression. The Library Working Group of X3J16/WG21, the joint 
ANSI/ISO standards committee for C++, anguished quite a bit be- 
fore recommending this change. The joint committee anguished a 
bit more in turn. But eventually, the predominant wisdom was that 
the Standard C++ library had bloody well better use the full lan- 
guage in this case, not just the bits that were available when new 
and delete were first added to C++. 

A persuasive argument is that very few programs truly check 
all new expressions for null pointers. Those that don't may well 
stumble about when the heap is exhausted — they're almost cer- 
tainly better off dying a clean death. Those that do check all such 
expressions often simply abort — the path to abnormal termina- 
tion is now just slightly different. It is only those few sophisti- 
cated programs that try to do something nontrivial when heap is 
exhausted that need a bit of rewriting. Most of the joint committee 
felt this was a necessary price to pay to introduce exceptions at 
this critical juncture. 

Even so, some sympathy remains for being able to revert to the 
old behavior. For a variety of reasons, the Library Working Group 
has not spelled out a portable way to do so. But the group has 



Listing 1 The header <new> 



#ifndef _NEW_ 
#def i ne _NEW_ 
^include <exception> 

// class xalloc 
class xalloc : public xruntime { 
protected: 

// virtual void do_raise(); 
public: 

xalloc(const char * = 0, const char * = 0); 

virtual -xallocO; 

}; 

// function and object declarations 
fvoid_t *set_new_handler(fvoid_t *); 
void operator deletetvoid *); 
void operator delete[](void *); 
void *operator new(size_t); 
void *operator new[](s1ze_t) ; 
void *operator new(size_t, void *); 
extern fvoid_t (*_New_hand); 
#endif 
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Standard C 



P.J. Plauger 



identified what it thinks should be a common extension. Calling 
set_new_handler with a null pointer argument is otherwise unde- 
fined behavior. It seems natural to use this nonportable call as a 
way for implementations to know that they should revert to the 
older behavior. 



ing your own. (Only the array versions of these two operators, 
described below, also enjoy this special status within the Standard 
C++ library.) 

Before I go into details, please note an important distinction 
here. When you write: 



Replacing operator new(size_t) 

If you want more certain control over the business of allocat- 
ing storage, your best bet is to provide your own versions of op- 
erator new(size_t) and/or operator delete(void *). These 
functions have a peculiar dispensation — the library provides a 
version of each, but you can "knock out" those versions by defin- 
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Thing *p = new Thing; 

the new Thing part is called a "new expression." It calls operator 
new(size_t) to allocate storage, but it also does other things, such 
as constructing the newly allocated object. All that operator 
new(size_t) has to worry about is providing the number of re- 
quested bytes, suitably aligned, or dealing 
with heap exhaustion. Listing 3 shows one 
way to write this function. 
Similarly, when you write: 

delete p; 



the delete p part is called a "delete ex- 
pression." It calls operator delete(void *) 
to free storage, but it first destroys the ob- 
ject (only if the pointer is not null, of 
course). All that operator delete(void *) 
has to worry about is freeing storage for 
the object. Listing 4 shows one way to 
write this function. 

So one thing you might do is replace 
operator del ete( void *) with a function 
that doesn't really free the storage. That 
could be handy while you're debugging a 
program, provided of course that you have 
enough heap to run your test cases. 

Or you might replace both operator 
new(size_t) and operator delete(void *) 
with versions that are simpler, or faster, or 
more sophisticated than the library ver- 
sions. It is important to replace both, be- 
cause the latter function in the library only 
knows how to free storage for objects allo- 
cated by the former. 

In either case, you probably don't have 
to bother with set_new_handler. You are 
at liberty to do whatever you want when 
you run out of heap. No need to call the 
new handler, which you can't easily do 
portably anyway. 

Placement Syntax 

Yet another latitude granted by the C++ 
language is to provide an arbitrary set of 
additional arguments in a new expression, 
as in: 

Thing *get_special (Tl stuff, 

T2 more_stuff) 

{ 
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return (new (stuff, more_stuff) Thing); 
} 

This form implicitly calls the function: 
void *operator new(size_t, Tl, T2); 

which you are obliged to supply. I leave it to your imagination 
what extra parameters might be useful when you're allocating 
some of your more sophisticated objects. 

It doesn't take too much imagination, however, to see a very 
common need. Sometimes you know exactly where you want a 
C++ object to be constructed — you have reason to believe that 
the storage area X is large enough and suitably aligned to hold an 
object of type Thing. Moreover, you're confident that no object 
has been constructed there already for which a destructor will later 
be called. (Whew!) 

To deal with this twilight zone between C and C++ program- 
ming, you can write: 

Thing *p = new ((void *)&X) Thing; 

This, naturally enough, calls the function: 

void *operator new(size_t, void *); 



Standard C 

which can simply return its second argument, as shown in Listing 
4. The Standard C library provides this one version of a placement 
operator new. (Don't forget to include the header <new> to be sure 
it is properly declared.) Any fancier placement variants are up to 
you to provide. 

Member operator new 

Yet another way exists for controlling how objects get allo- 
cated. For any class, you can overload all the variants of operator 
new and/or operator delete that I've mentioned so far. Perhaps 
you want to write your own versions of: 

void *Thing: : operator new(size_t); 
void Thing: :operator delete(void *); 

that does a really fast job of allocating and freeing objects of class 
Thing. It can, for example, maintain a list of previously freed ob- 
jects and hand them back quickly for future allocation requests. 
Unless you really get tricky, you can even ignore the size_t first 
argument to all variants of operator new, since you know how big 
a Thing is likely to be. (How do you get tricky? Well, you can 
make operator new virtual in the base class and fail to override it 
in a derived class. But thinking about things like that gives me a 
headache.) 

So you see that you can exercise pretty fine control over how 
all objects, or even individual objects, get allocated. 
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Listing 2 The function operator new(size_t) 



// operator new(size_t) REPLACEABLE function 
^include <stdl1b.h> 
^include <new> 

void *operator new(size_t size) 

{ // try to allocate size bytes 
void *p: 

while ((p = malloc(size)) == 19 &S _New_hand \= 0) 

(*_New_hand)(); 
return (p); 
) 

// End of File 



Listing 3 The function operator delete(void *) 



// operator delete(void *) REPLACEABLE function 
include <stdl1b.h> 
#1nclude <new> 

void operator delete(void *p) 

{ // free an allocated object 

free(p); 

) 

// End of File 
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cation and freeing of arrays. You can, for example, write: 
Thing *p = new Thing[N]; 

to allocate an array of N elements each of type Thing. Each of the 
elements is constructed in order, starting with the first (element 
zero). In this case, you must write the expression statement: 

delete[] p; 

to delete the array, not just a simple: 

delete p; ^^^^^ mmmm 



age for its own bookkeeping, so you'd better honor the size_t 
argument blindly. But at least you can maintain private storage 
pools now for array objects. 

For completeness, the draft C++ standard also includes global 
versions of: 

void *operator new(size_t); 
void operator delete(void *); 



as before. Why? Because the "array new 
expression" above has to somehow memo- 
rize how many elements H it has allocated. 
It needs to know to locate this memorized 
information and use it to destroy the ap- 
propriate number of elements and free the 
appropriate amount of storage. Yes, some 
existing implementations of C++ let you 
be cavalier about deleting arrays the wrong 
way, but don't count on that license in a 
portable program. 

This requirement presents another prob- 
lem. What happens if you've provided a 
member operator new(size_t) for class 
Thing, as above? It cannot, in general, 
know whether it's being asked to allocate 
storage for a single element or a whole ar- 
ray. (Remember the potential trickery I 
mentioned above.) So what C++ has done 
in the past is to ignore any such member 
functions and call the global operator 
new(size_t) for all array allocations. This 
has been a less than satisfactory solution. 

The joint committee has plugged this 
control gap by permitting you to define 
functions such as the members operator [J 
new(size_t) and operator delete(void 
*). Defining these functions gives you 
control over the allocation and freeing of 



Listing 4 The function 
operator new(size_t, void *) 



// operator new(size_t, void *) 
^include <new> 

void *operator new(size_t, void *p) 
{ // allocate in place 
return (p); 
} 

// End of File 
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: clear and easy to use 
dialog boxes. And, of 
course, controls can 
also be temporarily 
generated by a pro- 
gram and driven by 




with 

the 

integrated Kolibri Resource Manager you j 
can also develop extensive projects very 
quickly, and save on Windows System 
Resources. 
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support comes free direct from the deve- 
lopers by telephone, fax, CompuServe* 
and Mailbox. 




KOLIBRI 



Custom Control Library 



NORTH & SOUTH AMERICA 

European Software Connection 
P.O. BOX 1982, Lawrence, KS 66044, USA 
phone: (913) 832-2070, fax: (913) 832-8787 
Compuserve 71141,3624 
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ELSEWHERE CONTACT 

softronic GmbH, Englerstr. 9 
D-77652 Offenburg, Germany 

phone: (+49) 781 74021, fax: (+49) 7$| 740231 

Compuserve 100031,510 
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The library versions of these functions just turn around and call 
the non-array library versions, so I won't show you the code for 
them. And you can indeed knock these functions out with your 
own definitions, but I'm not sure why you'd bother. Doubtless, 
someone more clever or perverse than I can make a case for any 
feature added to C++. 

Type Information 

There is one last aspect to the language support library. It is 
rather small compared to exceptions (all of last month's install- 
ment) or storage management (most of this month's). I tack it on 
here for completeness. 

Another relatively recent significant addition to the draft C++ 
standard is "run-time type identification" (or RTTI, for short). Ba- 
sically, it adds the operator typeid for obtaining various bits of 
information on the type of an object (or expression). The operator 
yields an object of class typeinfo, defined in the header <type- 
info>. Listing 5 shows one way to write this header. 

The exception bddtypeid is reported in those cases where the 
type cannot be determined statically at translation time. If, in the 
process of chasing down the actual object, the program encounters 
a null pointer, you can guess what happens. 

(If you're put off by all these names made from words run 
together, you're not alone. There's a good chance that the joint 
committee will approve a new naming convention that involves a 
more liberal use of underscores to separate component words in 



names. So don't be surprised if many of these compound names 
change in the coming months.) 

What can you do with an object of class typeinfo! Well, you 
can obtain some sort of name for the type, for one thing, type- 
info::name() yields a null-terminated multibyte string (or 
NTMBS, in the jargon of the draft C++ standard) that presumably 
says something meaningful about the type. There are no standard 
names defined, so far, not even for the builtin types. 

You can also compare two objects of class typeinfo for equal- 
ity or inequality. Within any given program, you can expect two 
such objects to compare equal only if they derive from two ex- 
pressions of the same type. Don't expect to be able to remember 
these critters in files, however, and check for type equality across 
programs. Even running the same program twice doesn't promise 
to yield the same representation of a typeinfo object for the same 
type each time. (I have indicated that the type information can be 
represented as an int, but that is just illustrative, not a require- 
ment.) 

Finally, you can impose an ordering on all the types within a 
program, typeinfo: :before(const typeinfoi) returns nonzero for 
an object that represents a type earlier in the pecking order than 
the argument object. Once again, however, no promises are made 
about the rules for determining this order, or whether they're even 
the same each time you run the program. 

I'm sure far more can be said about the uses of RTTI, but I'm 
not the one to say it at this point in my career. Even if I were, this 
is not the place to say it. For now, you know what the standard 
C++ library has to know about RTTI. □ 
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Game programmers demand cutting edge performance when it comes 
to graphics technology. Fastgraph brings you the secrets of the gaming 
professionals at a price you can afford, 
g Feature-rich, versatile and powerful, Fastgraph supports most languages 
~~ and video modes. Use Fastgraph, it's the right tool for the job! 



| " an:i 



Ted Gruber Software •*i£tLAii 
P.O. Box 13408 • Las Vegas, NV 89112 
Orders/Info: (702) 735-1980 • FAX: (702) 735-4603 

BBS: (702) 796-7134 • CIS: 72000,1642 
Call for a free demo disk or download an evaluation kit 
from our BBS today. No run-time royalties. 
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Listing 5 The header <typei nf o> 



#i fndef _TYPEINF0_ 
#def1ne _TYPEINF0_ 

// class badtypeld 
class badtypeld : public xloglc { 
protected: 

// virtual void do_raise(); 
public: 

badtypeidO; 
virtual -badtypeidO; 

ft 

II class typeinfo 

class typeinfo { 

const char *_Name; 

const int _Desc; // implementation dependent 

typeinfot const typeinfoS); 
typeinfoi operator=(const typeinfo*); 



public: 



virtual -typeinfoO; 

1nt operator==(const typeinfo*) const; 

int operator!=(const typeinfo* _Rop) const 

{return (!(*th1s = _Rop)); } 
int beforet const typeinfoi); 
const char *name() const {return (_Name); } 
}; 



#end1f 
// End of File 
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Master the art of multi-platform GUIs. 

XVT Software is the leading choice of world-class 
developers for one reason: It is the simplest, quickest path 
to building quality applications that port to every GUI 
without compromises in look-and-feel or performance. 
Plus, it's easier to learn and use than native toolkits, so your 
time and effort goes into your application, not your GUIs. 

XVT gives you simultaneous original GUIs. 

Because XVT uses native GUI objects, your application 
is indistinguishable from one written directly to the native 
toolkit. Through our layered architecture, you achieve 
equivalent cross-platform functionality appropriate to each 
GUI, without the overhead and inflexibility of proprietary 
emulation-based systems. 



XVT puts complete C/C++ 
solutions at your fingertips. 

XVT Development Solutions for C include an 
Interactive Design Tool. Solutions for C++ include an 
object-oriented application framework. Both include the 
XVT Portability Toolkit. 

When combined with in-depth consulting, training 
and support, plus a wide range of Partners products, XVT 
forms the most comprehensive and advanced solution 
for developing completely portable GUI applications. 
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Developers judge XVT to be a masterpiece. 

XVT is the base document for the IEEE's GUI 
standardization effort. Our thousands of customers include 
internal and commercial developers like: Alcoa, Amoco, 
AT&T, Avis, Ford, General Motors, Grammatik/Reference 
Software, Kodak, Lockheed, NCR, NEC, NIST, Novell, 
Rockwell, Siemens, Sony, Southwestern Bell, Tandem, 
Uniplex, Unisys, US Army and US West. 

Call now (or a Free XVT Demo 
and Technical Overview. 

1-800-678-7988 






SOFTWARE INC 

The portable GUI development solution. 

XVT Software Inc. 4900 Pearl East Cir. Boulder, CO 80301 
(303) <H3-«23 FAX (303) W3-0%9 
For European inquiries, contact: Precision Software GmbH 
Phone: 49 61 03/37 94 Fax: 49 61 03/36 95 5 
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Let Diab Data's D-TECTIVE 
Read Your Bugs Their Rights! 



Are your efforts to get production-quality software 
out the door being dogged by suspicious, recur- 
ring, and persistent bugs? Put Diab Data's 
D-TECTWE on the beat! 

D-TECTIVE is the latest word in GUI, multi- 
tasking, multi-target, remote, source-level 
debuggers for Motorola's 680x0 and CPU32(+) 
family of embedded controllers and microproces- 
sors, and it runs on the most popular platforms, 
in-circuit emulator tools, and real-time operating 
systems. 

You've already heard about the legendary 
performance of Diab Data's D-CC/68K — the 
fastest, most reliable compilers for Motorola's 
680x0 family of processors. Now, the industry's 
recognized leader in high-performance globally 
optimizing compilers has added proven debugging 



technology to its D-CC/ 68K software development 
tool arsenal. 

Protect your code's performance and quality 
with D-CC/68K and D-TECTIVE— the smartest 
one-two punch available anywhere to get your 
Motorola-based embedded project to market fast 
and guarantee that it'll be a star performer. 

Stop bugs and quality glitches from arresting 
your development! Let D-TECTIVE read'em their 
rights! Call Diab Data now to learn more about the 
most arresting software tools in the industry and 
our FREE evaluation program. 

DiabAdaix 

A Bull Company 

U.S.: Telephone: (415) 571-1700 • Fax: (415) 571-9068 
Europe: Telephone: +46-8 622-4422 • Fax: +46-8 622-4223 
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Symbolic Access 
To Embedded Controllers 
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Introduction 

A PC often functions as the user interface, debugging tool, and 
general supervisor of an embedded controller. With this arrange- 
ment it is important for the programs that transfer parameters be- 
tween the PC and the controller to maintain agreement on the 
names and meanings of all variables. If the PC sets parameter 63 
to the value of 123, for instance, the PC and the controller must 
agree on what parameter 63 is and what the value 123 represents. 
This consistency is especially at risk during development because 
new parameters are sometimes introduced on-the-fly and often end 
up in different locations on the two computers. The processors 
may not even agree on a format for the values. (An Intel PC could 
be storing numbers in big-endian format while a Motorola control- 
ler might want them in small-endian format.) 

A symbol table is an efficient solution to the consistency prob- 
lem because it allows the data structures of the PC and controller 
to develop separately, yet links the two systems with a simple 
communication protocol. By this method, which resembles the 
message format found in the general-purpose interface bus (GP- 
IB), values are referenced by their symbolic name, e.g. mess- 
ured_pH, heater_power etc. We used this principle to control a 
group of bioreactors. Each reactor is controlled by an embedded 
controller which communicates with a supervising PC for operator 
instructions and data logging. 



How Things are Connected 

Figure 1 illustrates the information flow in the system. In our 
implementation the PC is always the initiator of communication 
and the embedded controller only responds to received messages. 
The most important entries in the symbol tables are the parameter 
names and their values. (In this context a parameter is more gen- 
eral than a constant. It can also represent measured data, debug 
information, etc.) Parameter values move from the PC symbol ta- 
ble to the controller symbol table through messages sent over the 
RS-232 line. The PC symbol table can be altered either by access- 
ing the user interface or by causing the PC to read a refreshed 
version of the parameter file. The new data is then sent to the 
symbol table in the embedded controller. The controller symbol 
table can thus be changed from the PC, or through the measure- 
ment and control algorithms of the controller itself. Parameters for 
the control algorithms are stored in the EEPROM, enabling the 
controller to initialize its symbol table values at start-up and main- 
tain its control process by itself should the PC fail. 

The Symbol Tables 

Both the PC program and the embedded controller program are 
centered on their respective symbol tables. The structure of the PC 
symbol table is: 
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Create, edit, and test help quickly 
in an integrated environment! 

We've sliced the hypertext help 
development time from days to 
hours! Forget about footnote or 
RTF programming or using Word. 
The Help Magician comes with a 
30-day money back guarantee. 

New version 2.5 features 

□ No memory limitations 

□ Supports 3.1 Help Compiler 
features such as non-scrolling 
regions and secondary windows 

□ Set background colors 

□ Advanced paragraph formatting 

□ Full macro support 

□ Jump to other help files 

□ Multiple file support 

□ Help window sizing 
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typedef struct { 
char *nanie; 
int ival; 
double fval; 

void *(*scalefunc)(void *); 
char eeProm; 

char file;} symTabEntry; 

Each of the process variables maintained 
by the controller (temperature, oxygen level, 
pH, etc.) is represented as a record in the 
symbol table. Every record in the table con- 
tains a unique name (e.g. measured j)H), an 
integer or double floating-point value, and 
a pointer to an optional scaling function. 
The table also contains two flags: eeProm 
and file. If eeProm is set to TOJEE, the re- 
cord will be transferred to the controller 
upon start-up, and will be stored in the 
controller EEPROM if its value is different 
from the one already residing there. The 
f 7 le flag indicates whether the current re- 
cord contains data associated with the sys- 
tem's parameter file. This parameter file 
contains parameter names (of process vari- 
ables and other system variables) and their 
values. If the system finds a particular pa- 
rameter name in the file during startup, the 
system copies the parameter's value into 
the record, and sets a bit in the file flag. 
Likewise, if the user later wants to save 
the current parameter values back to the 
file, the system will save only those pa- 
rameters whose file flags are set. While 
the system is operating, a record holds a 
parameter's value in either ival (for inte- 
ger parameters) or fval (for floating-point 
parameters). 

The user interface is also oriented to 
the symbol table. The user can change pa- 
rameters by choosing a parameter window. 
Each parameter entry field knows the 
pointer to its entry in the symbol table. It 
can thus read and write the value and call 



the scaling function. When the user 
changes a parameter, the new value is im- 
mediately scaled from floating-point to in- 
teger and transmitted to the controller. Be- 
cause values are referred to by name 
rather than by pointer, the set-up of the 
parameter windows is simplified. 

The symbol tables are alphabetically 
sorted, which allows the processor to use a 
binary search when looking for a name. 
(A binary search is faster than a linear 
search, but if the tables were large, I 
would consider using hash-tables.) The 
programmer will now and then insert new 
entries to the tables at a wrong position. 
On start-up both the PC and controller 
programs therefore go through their tables 
and check for alphabetic order. If unor- 
dered elements are found, the function is- 
sues an error message. 

The structure of controller's symbol ta- 
ble is 

typedef struct { 
char *name; 
int ival; 

char *(*func)(char *); 
int eeOffset;} symTabEntry; 

name is the name of the parameter, ival 
the value, and the function pointer either a 
function that can be invoked by a message 
or a hook for individual processing of re- 
ceived parameters. eeOffset is the EEPROM 
address where the parameter is stored. 
(Parameters that are not saved in EEPROM 
have an offset value of -1.) 

The controller's program runs peri- 
odically, e.g. every five seconds. The pro- 
gram first reads all measurements and 
stores the values in the symbol table. The 
control algorithms then take their values 
and parameters from the symbol table and 
calculate responses. The results are stored 



Figure 1 Information flow through the system 
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At Fidelity Investments®, we take the best available 
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Symbolic Access to Embedded Controllers 

uuui ju> i*n.i 1 1// -fjnoci.jjuiiii,-jjniueaiui eu. ihis can oe programmed as: 

Fi ndSymbol ( "pHerror" ) ->i val = 
Fi ndSymbol ( "pHsetpoi nt" ) ->i val 
- Fi ndSymbol ("pHmeasured")->ival ; 

Fi ndSymbol returns a pointer to the symbol table entry with the 
given name. However, less typing and a faster program are achieved 
by initializing pointers to the symbol table entries at start-up: 



Odd A.S. Olsen and PettPr H HPvorHahl 
etc. and coding the algorithm as 

*ppHerror= *ppHsetpoint - *ppHmeasured; 

At start-up the symbol tables are initialized according to the fol- 
lowing sequence. First the tables are initialized with the values speci- 
fied at compile time. The controller then reads values from the EEPROH 
into its table. The PC reads a parameter file, which may change some 
of the values in its table. The PC program will then transfer those 
values having flag T0_EE set to the controller 
EEPROM and symbol table. 
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Message Format 

The messages between the PC and con- 
troller are ASCII strings sent over an RS- 
232 connection. Before transmission the 
message assembler adds a checksum. The 
receiver checks and removes the checksum 
from the message before passing the mes- 
sage to the message interpreter. 

Each message consists of one or more 
submessages. The submessages and their 
elements can be separated by spaces and 
have the following format: 

<name><operator>[<val ue>] 



Listing 1 Message interpreter 
definitions and function prototypes 


1* parsdef.h */ 




/* No copyrights claimed 


*/ 


//define ERROR 


1 


//define EMPTY 


2 


#define ASSIGN 


3 


//define REQUEST 


4 


//define TO EEPROM 


5 


//define IS 


6 


//define COMMAND 


7 


//define INTEGER 


8 


//define NAME 


10 


//define NAME ERROR 


11 


//define OP ERROR 


12 


//define VAL ERROR 


13 


//define END ERROR 


14 


//define POOL ERROR 


15 


//define UNDEF SYMB 


16 


//define NOT EEPROM 


17 


//define UNDEF FUNC 


18 


//define MAX TOKEN LEN 


10 


//define MAX STATEMENTS 


20 


//define STRINGPOOL 


80 


//define MESSAGELENGTH 


80 


typedef struct { 




int command; 




int type; 
char *name; 






int value; 




3 toOoUst; 
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The name field is the symbolic name of a parameter or a com- 
mand. The operator is a single character as given in Table 1. For 
messages with an associated value, the value field is the numerical 
value of the parameter. The name must begin with a letter (a-zA- 
Z), followed by a number of letters, digits, or underscores (a-zA- 
Z0-9_). In our implementation the value field is always an integer 
because all processing in the controller is integer based. 

To add other value types the programmer need only define 
new operators and modify the structures and programs accord- 
ingly. A floating-point type is useful in some systems. A string 
type can also be of use, for example to transfer strings directly to 
an operator display on the controller. In a multi-processor embed- 
ded system, the string type can be used to transfer messages ver- 
batim to subprocessors. 

The following message transfers temp_setp=20 to EEPROM, sends 
delay=10 to the symbol table, requests the present value of temp, 
and executes the function pwr_sav. 

temp_setp>20 del ay=10 temp? pwr_sav! 

The response might be 

temp: 22 pwr_sav#16 

The error message indicates that pwr_sav was not found in the 
symbol table of the controller. (Such error messages are hopefully 
only encountered during program development.) In this case the 
message indicates a discrepancy between the PC and controller 
programs. 



Message Interpretation 

The interpreter parses the received messages into a task list 
which is handed over to an execution function. The structure of 
the list records is: 

typedef struct { 
int command; 
int type; 
char *name; 

int value; } toDoList; 

command is a value specifying the command, type the type of the 
value (in this case always INTEGER), *name a pointer to the name of 
the parameter, and value the numerical value of the parameter. 



Table 1 Message formats and operators 


<name> = <value> 


Assign value to parameter name 


<name> ? 


Request the value of parameter name 


<name> > <value> 


Transfer value to the EEPROM 


<name> : <value> 


Current value of parameter name 


<name> ! 


Execute name-command 


<name> # <value> 


Error code value associated with name 



In the controller the interpreter and reply assembler are inte- 
grated. In the PC, however, parameters are sent through a message 
assembler and replies decoded in a separate interpreter. The re- 
ceiver is interrupt driven and executes the interpreter after a full 
message has arrived. The interpreter places the received values 
into the symbol table and transfers error messages to the user in- 
terface. The PC interpreter resembles the controller interpreter, 
which I am about to describe. 

A Sample Application 

This slightly modified version of the controller's interpreter 
and message assembler will illustrate message handling and sym- 
bol table operations. (This version runs on a PC.) Listing 1 pre- 
sents the definitions and function prototypes; Listing 2 shows the 
main program and message interpreter. 

The main program reads a message from the keyboard. It parses 
the message, then prints and executes the task list toDo. The task 
list is a list of structures with one entry for each subcommand. 
The Parse function assumes the message is formated as defined in 
Table 1. Since the grammar is quite simple, there is no need for 
recursive descent or other strategies used in compilers. There are 
several tests that check adherence to the format, and issue error 
messages if discrepancies are found. (This is most valuable during 
program development.) Finding an error stops the message inter- 
pretation. Inserting an EMPTY command terminates the list. 

GetNextToken reads the next token in the message string. If the 
first character encountered is a letter, the token is a name. If it is a 
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Listing 1 continued 



typedef struct { 
char *name; 
int ival; 

char *(*func)(char *); 

int eeOffset; /* -1 if not saved in eeprom */ 
} symTabEntry; 



char *Assign(toDoList *pL, char *pTx); 
void DoCommandsttoDoList *pL); 

symTabEntry *FindSymbol (char *name); 

char *GetNextToken(char *begin, char *token, int *type); 

void Parse(char *message, toDoList *pL); 

void PrintToDottoDoList *toDo); 

char *Request(toDoL1st *pL, char *pTx); 

char *Reset(char *ptr); 

char *RunCommand(toDoList *pL, char *pTx); 

char *SayError(toDoList *pL, int err, char *cp); 

int StoreToken(char **strp, char *token); 

int SymCmpt symTabEntry *a, symTabEntry *b); 

char *ToEeprom(toDoL1st *pL, char *pTx); 

char *TxBuffer(void); 

void WriteEeprom( symTabEntry *pSym, int type); 



/* End of File */ 



digit, the token is a value. If the first character is neither a name 
nor a value, the token is an operator. The function then copies the 
token into the token string of the parser and sets the type parame- 
ter according to the type. The size of the token-string (HAX_T0- 
KEN_LEH) must be larger than the longest token that can occur. The 
type parameter is set equal to the operator's defined constant. 

Parser calls StoreToken to save the encountered names in a 
string pool. This pool is recycled for each message by setting 
pPool=stringPool. The pool size (STRINGPOOL) must be large 
enough to store all the names that can occur in one message. The 
address of the name is stored in the name element of the structure. 

The task list toDo can now be processed by calling DoCommands. 
This function is essentially a loop which executes the commands 
through a switch statement. However, it first initializes a pointer 
to the beginning of the txBuffer, where the response message is 
stored. This buffer might be local to the more hardware-dependent 
parts of the program and not globally accessible, so this requires a 
function call to obtain the pointer. All functions called in Docom- 
mands maintain the buffer pointer by accepting it as an argument 
and returning the possibly changed value. 

SayError writes an error message to the transmit buffer. It re- 
ceives a pointer to the task list, where it finds the name relating to 
the error, and the error number. 



Listing 2 The message interpreter and assembler for the embedded controller, implemented on a PC 



I* pars.c */ 

/* no copyrights claimed */ 
^include <stdio.h> 
include <stdlib.h> 
^include <ctype.h> 
#include <string.h> 
^include "parsdef.h" 

static toDoList toDo[MAX_STATEMENTS] ; 
static char stringPool [STRINGPOOL]; 
static char *pPool, *poolEnd; 
static char message[MESSAGELENGTH] ; 
static char *messList[]= { 

"EMPTY" ."error" ."empty" , "assign" , "request" . 

"to_eeprom" ,"i s" , "command" , "i nteger" , "float" , 

"name"."name_error","op_error","val_error", 

"end_error","pool_error" 

}; 

mainO 
{ 

while(l) { 

pPool= stringPool ; 
poolEnd= stringPool+STRINGPOOL-1; 
printf("\nmessage: "); 
gets(message) ; 
if(message[0]==\ ') break; 
Parse(message, toDo); 
PrintToDo(toDo); 
DoCommands (toDo); 

1 

} 

/* first, the parsing */ 

void Parsetchar *message, toDoList *pToDo) 
{ 

char *pC, token[MAX_TOKEN_LEN+l] ; 



int type, i ; 
pC= message; 

for(i=8; i<MAX_STATEMENTS; i++) { 

(pToDo+l)->command= EMPTY; /* mark end */ 
if(*pC=='\0'){pToDo->command= EMPTY; return;} 
/* get name */ 

pC= GetNextTokentpC. token, &type); 
if(StoreToken(&pToDo->name, token) != 0) 

{ pToDo->command=P00L_ERR0R; return; } 
i f ( ( type==ERROR) 1 1 ( type ! =NAME ) ) 

{ pToDo->comniand= NAME_ERROR; return; } 
if (*pC=='\0" ) {pToDo->command=EMPTY; return;} 
/* get operator */ 
pC= GetNextTokentpC, token, &type); 
if(type==ERROR) 

{pToDo->command=OP_ERROR; return;} 
pToDo->command= type; 
/* get value */ 

i ft (type-ASSIGN) 1 1 (type==T0_EEPR0M) 1 1 
(type==IS)) { 
1f(*pC=='\0') 

{pToDo->command=VAL_ERROR; return;} 
pC= GetNextTokentpC, token, itype); 
pToDo->type= type; 
if(type==INTEGER) 

pToDo->value= atoi (token); 
else {pToDo->command= VAL_ERR0R; return;} 

} 

else pToDo->type= INTEGER; 
if(pToDo->command== EMPTY) return; 
pToDo++; 

} 

pToDo->command= END_ERR0R; 
return; 



char *GetNextToken(char *begin, char *token. int *type) 

t 
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Wind River Systems Needed a Real-Time 
Development Environment for Windows. 

They Selected MULTI for VxWorks. 
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In a multi-tasking environment, 
each task can have its own window. 




Cortrol Run 


Display 




Remote 
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int loopCount = 0; 
0x3a3d74: MOVEQ #0,D3 

tffdef STATUS JNFO 

printl ("Entering windDernoln"); 
*endif r STATUSJNFO H 

if (Seration == 0) 
0x3a3d76. TST.L 02 
0x3a3d78: BNE windDemo* 

0x3a3d7a: MOVE! #10000,D2 

/* create objects used by the cr 



windDemo:0x39c498 



Control Run Display Show Remote State 



\ rnsgQId 
^ 0x3a3dS0: 

« 0x3a3d82: 
Bsm^0x3a3d86: 

» 0x3a3d8a: 

• 0x3a3d90: 

semid 

• 0x3a3d96: 

• 0x3a3d9a: 

• 0x3a3d9e: 



* msgQCreate (MAX J 
CLR.L -(A7) 
PEA ($8).W 
PEA (J1).W 
BSR msgQCreati 
MOVE! D0,msgQld 
= semBCreate (SEM_Q 
PEA ($1).W 
PEA ($1).W 
BSR semBCreati 



STOPPED INSIDE tile: windDemo.c 
♦| running 'windDemo' 
Stopped by breakpoint 



♦Id 



proc: windl \ 
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void windDemo 
( 

int iteration P 

) 
( 

int loopCount = 0; /* 

#ifdef STATUSJNFO 

printt ("Entering windDemoW); 
#endi( /• STATUSJNFO «/ 

if (iteration « 0) f 
iteration = 10000; 

/* create objects used by the child tasks V 

msgQId = msgQCreate (MAX _MSG, MSGJ3 
semld » semBCreate (SEM_Q_PRIORITY, SE 
wdld • wdCreate (); 

windDemold = taskldSelf (); 

FOREVER 
( 



file: windDemo.c proc: windDemoO 



runtask windDemo 
running 'windDemo' 
Stopped by breakpoint 

D 



help 



setargs 



stops 



quit 
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® Stop On Task Creation 


® Debug 
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3da354 


tLogTask logTask 


PENDING 









3dSfc6 


tNetTask netTask 


PENDING 


50 






3bab2c 


tRIogind rlogind 


PENDING 


2 






3b8c88 


tTelnetd telnetd 


PENDING 


2 






3b7770 


tPortmapd portmapd 


PENDING 


100 






3b6258 


IRdbTask rdbTask 


DELAY 


20 






3b3da0 


tFtpdTask ftpdTask 


PENDING 


55 






3ac1 bO 


tShell shell 


PENDING 


1 






3a1448 


tRdbRun 


PENDING 


100 






39C498 


tRdbRun windDemo SUSPEND 


100 






3974e8 


tRdbRun windDemo SUSPEND 


100 






392538 


tRdbRun windDemo SUSPEND 


ion 





( 

int 

) 
< 

int loopCount = 0, 

flfdef STATUSJNFO 

printt ("Entering windDemoW); 
#endif f STATUSJNFO V 

if (iteration « 0) 

iteration » 10000, 



t number of I 



» M agfauKl 



/* create objects used by the child tasks V 



file: windDemo.c proc windDemoO 



help 


go 


step 


next 


return 


halt 


restart 


setargs 


locals 


profile 


calls 


stops 


regs 


search 


pop 


assem 


edit 








quit 



You Can Use MULTI for Your Real-Time Applications Too. 



MULTI: The Most Comprehensive and 
Completely Integrated Embedded Solution 

MULTI is a multi-language embedded development 
environment featuring source-level debugging, execution 
profiling, memory leak detection, graphical class browser, 
program builder, built-in editor, and source code control. 

MULTI is tightly integrated with other code development 
tools such as compilers, assemblers, linkers, librarians, and 
target execution environments including simulators, ROM 
monitors, and in-circuit emulators. 

MULTI incorporates the Green Hills optimizing compilers 
to achieve a development environment with a common user 
interface for 5 languages and all popular 32 and 64-bit 
target microprocessors across a wide range of host 
development platforms. Green Hills compilers use 100+ 
optimizations to produce unmatched code for your toughest 
applications. 



Languages 

• C • C++ • Fortran • Pascal • Ada 

Host Development Platforms 

• Microsoft Windows • Unix Workstations • VAX/VMS 

Target Microprocessors 

• 680x0/683xx • 80386/80486 • SPARC 

• R3000/R4000 • i960 • V8 1 

Call (800) 500-2580 Today 
for a Free MULTI Demo! 



Oasys 

One Cranberry Hill 
Lexington, MA 02 173 
Tel: (617) 862-2002 
Fax: (617) 862-3073 



Green Hills Software, Inc. 

510 Castillo Street 
Sania Barbara, CA93101 
Tel: (805) 965-6044 
Fax: (805) 965-6343 



© Copyright 1993 Green Hills Software. Inc. Green Hills Software and MULTI are trademarks of Green Hills Software. Inc. VxWorks is a registered trademark of Wind River Systems. All other trademarks are acknowledged to iheir respective owners. 
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GSS*CGI Graphic Tools now from EMATEK 

Soon available on all platforms: 
MS-Windows, Windows NT, OS/2 PM, Solaris, UNIX on PCs and workstations. 
Your application written with the GSS*CGI Graphic Tools 
will be portable to all platforms. 




Graphics Development Toolkit enables you to develop 
applications in a device and system independent way 
through the help of device-specific drivers based on the 
ISO CGI Standard. GSS*GDT consists of a library with 
more than 160 callable C and FORTRAN functions and is 
compatible with the graphics development tools from IBM 
and SCO. 

GSS*GDT is available for DOS, MS-Windows, Windows 
NT, OS/2 PM, Interactive Unix, Onsite Unix SVR 4.2 and 
Solaris. 

Versions for SCO Unix, UnixWare and HP Workstations will 
be soon available. 



iraphical Kernel System is a C and FORTRAN function 
library that enables you to develop portable graphic 
applications which include e.g. user interaction, coordinate 
transformation and object segmentation, based on the ISO 
GKS Standard. GSS*GKS, which is installed in large 
quantities on the DOS platform and has been proved 
successful for years, is now available for the graphical user 
interfaces and therefore offers the software developer a 
smooth transition to the new windowing systems. 
GSS'GKS is available for DOS, MS-Windows, Windows 
NT, OS/2 PM, Interactive Unix, Onsite Unix SVR 4.2 and 
Solaris. 

Versions for SCO Unix, UnixWare and HP Workstations 
will be soon available. 



DO 



EMATEK Vectorfont Toolkit enables you to integrate 
vectorfonts into your application. Supported font formats 
are PCL5, PostScript Type 1, TrueType and Bitstream 
Speedo. GSS'EVT offers a variety of additional elements 
and attribute functions like character height and gap, 
rotation and italicize angle, fill area pattern and outline- 
width, shadow, background boxes, leader and underlining 
as well as sub- and superscripting for scientific purposes. 
GSS*EVT is an add-on for GSS*GDT, GSS*GKS, 
MS-Windows SDK and will be ported to all popular 
graphical user interfaces. 



Graphics Charts Toolkit provides you with high-level 
functions to integrate presentation graphics into your 
application. With only a few calls you can output pie, bar, 
line, step, schedule or text diagrams on a display or 
printer. Each part of the chart can be altered through the 
related attribute functions. GSS*GCT is an add-on for 
GSS*GDT and GSS*GKS and will be ported to all popular 
graphical user interfaces, thus providing portable presen- 
tation graphic capabilities for all supported systems. 




Subbelrather Strasse 17- D-50823 Cologne, Germany 
Phone: +49-221 -512074 Fax: +49-221-529666 
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The functions Assign, Request, ToEeprom, and RunCommand each 
begin by getting a name from the task list and looking it up in the 
symbol table. If the name isn't found, they write an error message 
to the transmit buffer. 




} 



char *pC, 
int i ; 
pC= begin; 
pT= token; 
*token= '\0'; 
*type= EMPTY; 

1f(*pC == '\0') {return pC;} 
/* remove leading spaces */ 
whi!e(*pC==' ") pC++; 
1f(*pC=='\0') return pC; 
if(isalpha(*pO) { /* name */ 

*type= NAME; 

*pT++= *pC++; 

for(i=l; i<MAX_TOKEN_LEN; 1++) { 

1f((isalpha(*pO) II (1sdig1t(*pO) 

II (*pC=='J)) *pT++= *pC++; 
else { 

*pT= *\8'; 
return pC; 

} 

} 

*type= ERROR; 
return pC; 
) 

else if((isdigit(*pC))||(*pC== , +')|| 
(*pC=='-")) { /* number */ 
*pT++= *pC++; 

for(i=l; i<MAX_TOKEN_LEN; 1++) { 
1f(isdigit(*pO) *pT++= *pC++; 
else { 

*pT= 'W; 
*type= INTEGER; 
return pC; 

} 

} 

*type= ERROR; 
return pC; 

} 

else if (*pC== 
else 1f(*pC== 
else 1f(*pC== 
else if (*pC== 
else if(*pC== 
else {*type= 
return ++pC; 



=•) *type= ASSIGN; 
?') *type= REQUEST; 
>') *type= TOJEPROM; 
:') *type= IS; 
!") *type= COMMAND; 
ERROR; return ++pC;} 



int StoreTokenfchar **ppName, char *token) 

{ 

int length; 

*ppName= pPool; 

length= strlen(token)+l; 

if((pPool+length)>=poolEnd) return -1; 

strcpytpPool , token); 

pPool+= length; 

return 0; 

1 

/* and now, the action */ 
static symTabEntry symTab[> { 



Learn C++ & 

Windows'-Based 
Programming- 
Simply, Quickl 




The OML Learning Series is the most cost 
effective way to learn C++ and Windows- 
based programming in the privacy of your 
home or office. The highly interactive 
graphical interface provides an intuitive and 
speedy OOP learning environment on your 
PC*. Numerous exercises and examples 
help reinforce key concepts. OML offers: 

□ C/C++ Series (5 courses) 

□ OOA and OOD Series (2 courses) 

□ Visual Series (MFC 2.0,) 

□ Other Series (call) 

!l Training/Consulting (call) 

We believe the best way to convince yon 
thai our courses are the perfect tool for 
your object-oriented training is to use it 
personally. We have created a special 
evaluation package that includes our 
complete curriculum. With this package, 
you may review any part of any of our 
courses, up to 25% of each course. The 
evaluation package is priced at $20.00**. 

For a limited time, each course is available 
at the special price of $59.95 (regular 
price $129.95). Ask for our volume discount 
and student price. To order our courses or 
our evaluation package, call today: 



VISA/MC/AMEX accepted, s/h extra. 

• Requires MS-Windows or OS/2 2.0 VGA, 386 or 486, 
i mouse. 

$20. 00 fee will be applied toward the purchase 
aur first OML course, 
s is a registered trademark of Microsoft Corporation 




4165 Thousand Oaks Blvd. 
Suite 225 

Westlake Village.CA 91362 
Phone: (805) 373-8111 
Fax: 1805) 373-8110 



Object 

Management 

Laboratory 
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The Assign function inserts the value in the symbol table. The 
Request function reads the value from the symbol table and gener- 
ates a response submessage. ToEeprom puts the value into the symbol 
table and checks if the parameter has a place in the EEPROM. If 
eeOffset is greater than or equal to zero, it writes the value. If 
not, it issues an error message. RunCoumand executes the program 
pointed to in the symbol structure. If the pointer is NULL, Run- 
Command generates an error message. 

Assign, Request and ToEeprom all check for a function hook 
before returning. If they find one they call it. Assign, Request, and 
ToEeprom also maintain the transmitter buffer pointer so they can 
write to the buffer. 

The program was compiled with Borland TurboC++ version 
3.0. The library functions are all UNIX and ANSI defined, so us- 
ing other compilers should not present any problem. 



Final Thoughts 



This symbolic data transfer scheme enabled us to implement a 
complete control system from scratch in about one programmer- 
month. When we started we had no clear picture of what the final 
result would be, so parameters were constantly added and removed as 
we tried different control strategies. By using the described method, 
we were able to respond quickly to these changes. This arrangement 
also made it easier to add auxiliary parameters for debugging. There 
are of course faster ways to transfer data, but the kinds of proc- 
esses maintained by embedded controllers are often slow enough 
that a minor increase in response time isn't significant. □ 




The Tics Realtime multi-tasking kernel is a linkable C library that 
allows C functions to run as preemptive concurrent tasks. Developed 
forprofessional software developers who need a capable full-featured 
real-time multi-tasking development system. Tics can run with MS- 
DOS or stand-alone on an embedded target. No royalties. Tics also 
includes a multi-tasking COM port library for multi-tasking serial 
communications. 



- C source code is included - fully docu- 
mented and complete. 

- Includes our new book "The Art of Real- 
time Programming". 

- Tics is written entirety in C and is portable 
to virtually any microprocessor. 

- Includes integrated COM port library for 
multi -tasking RS-232 applications. 

- The PC timer chip is reprogrammed to 
specified granularity. 

- Preemptive, cooperative, or time-sliced 
scheduling, configurable on a task by task 
basis. 

- No restriction on the number of tasks. 

- Stack size is variable on a task by task basis. 

- Priorities can be changed dynamically. 

- Tasks may be created dynamically. 

- The development system also includes 
Tiny Tics, a small round robin kernel that is 
ideal for micro-controllers. 

- Tics requires less than 8K bytes of code 
space and is ROMable. 

- Three types of high speed timers: in-line 
pause, one-shot timers, and time critical 
periodic timers. 

790 Lucerne Drive Suite 78 
Sunnyvale, CA 94086 
iiriME (408) 723-2200 



- Differential timer management system al- 
lows for an unrestricted number of concur- 
rent timers without increasing time spent 
in the timer isr. 

- Inter-task communication using message 
queues or high speed mailboxes. 

- Critical region management. 

- Highspeed memory management system. 
Unrestricted number of memory pools. 

- Priorities on tasks and messages provide 
great flexibility. Priorities on messages 
means that high priority messages go 
straight to the front of the queue. 

- Optionally, cooperative tasks may share a 
common stack so that hundreds of tasks 
can run with the overhead of a single stack. 

- Object oriented. Create task instances 
with their own separate instance data. Can 
run with C+ + for real-time OOP. 

- Messages or mail can be sent from within 
an isr. 

- Time out option while waiting for a mes- 
sage. 

- Includes manual and source code for 
sample applications that include dials, 
gauges, data acquisition, display, and more. 

Price: $499 

Shipping & Handling: $5, $15 InL 



Listing 2 continued 



{"reset" , , Reset, -1}, 
{"status" , 35 , NULL , -1}, 
{"temp" , 16 , NULL , 20} 



void PrintToDoUoDoList *toDo) 
{ 

while(toDo->command != EMPTY) { 

pr1ntf("\n %s %s '*s"\ 
messList[toDo->command], 
mess Li st[toDo ->type] , toDo- >name ) ; 

1f(toDo->type==INTEGER) 

printfC 3Sd", toOo->value); 

toDo++; 



} 



} 



int SymCmp(symTabEntry *a, symTabEntry *b) 



return strcmp(a->name, b->name); 



symTabEntry *FindSymboi (char *pName) 

{ 

symTabEntry dummy, *p; 
dummy. name= pName; 

p= (symTabEntry*) bsearcht&dummy, symTab. 
si zeof(symTab)/sizeof (symTabEntry), 
sizeof (symTabEntry), 

(int(*)(const void*, const void*))SymCmp) ; 
return p; 

} 

char *Reset(char *pC) 



{ 



} 



printft "\nExecuting 'Reset'"); 
return pC; 



void DoCommandsUoDoList *pToDo) 

{ 

char *txBuffer, *pTx; 
txBuffer= pTx= TxBufferO; 
*pTx= '\0'; 

while(pToDo->command != EMPTY) { 
switch(pToDo->command) { 

case ERROR: 

case NAME_ERROR: 

case 0P_ERR0R: 

case VAL_ERR0R: 

case ENDJRROR: 

case POOLJRROR: 

pTx= SayError(pToDo, pToDo->command, pTx); 
break; 

case ASSIGN: pTx= Assign(pToDo, pTx); 
break; 

case REQUEST: pTx= RequesttpToDo, pTx); 
break; 

case T0_EEPR0M: pTx= ToEepromtpToDo, pTx); 
break; 

case COMMAND: pTx= RunCommandtpToDo, pTx); 
break; 

default: 



} 



break; 



++pToDo; 
} 

printf("\ntxBuffer: 'Ss'VT, txBuffer); 
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char *SayError(toDoL1st *pToDo, 1nt err, char *pC) 
{ 

char str[MAX_TOKEN_LEN+l] , *pS; 
pS= pToDo->name; 
whi 1 e ( *pC++=*pS++) ; 
PC-; 

*pC++= '§'', 

sprlntf (str,"%-d", err); 
pS= str; 

while(*pC++= *pS++); 
return --pC; 

} 

char *Assign(toDoLi st *pToDo, char *pTx) 

{ 

symTabEntry *pSym; 

pSym= FindSymbol(pToDo->name); 

if(pSym==NULL) { 

pTx= SayErrortpToDo. UNDEF.SYMB. pTx); 

return pTx; 

} 

i f ( pToDo->type==I NTEGER) pSym->1val= pToDo->value; 
if(pSym->func!=NULL) pTx= (*pSym->func)(pTx); 
return pTx; 

} 

char *Request(toDoL1st *pToDo, char *pTx) 



{ 



} 



symTabEntry *pSym; 
char *pS, str[MAX_TOKEN_LEN+l] ; 
pSym= FindSymbol(pToDo->name); 
if(pSym==NULL) { 

pTx= SayErrortpToDo, UNDEF.SYMB, pTx); 

return pTx; 

} 

pS= pToDo->name; 

while(*pTx++=*pS++); 

pTx-; 

*pTx++= '=': 

if(pToDo->type==INTEGER) 

spr1ntf(str."%-d", pSym->1val ); 
pS= str: 

while(*pTx++=*pS++); 

if(pSym->func!=NULL) pTx= (*pSym->func)(pTx); 
return --pTx; 



char *ToEeprom(toDoList *pToDo. char *pTx) 
{ 

symTabEntry *pSym; 

pSym= FindSymbol(pToDo->name): 

1f(pSym==NULL) { 

pTx= SayErrortpToDo, UNDEF.SYMB, pTx); 

return pTx; 

} 

1f(pSym->eeOffset<0) { 

pTx= SayErrortpToDo, NOT.EEPROM, pTx); 
return pTx; 

} 

1f(pToDo->type==INTEGER) { 
pSym->ival= pToDo->value; 
Wr1teEeprom(pSym, INTEGER); 

} 

1f(pSym->func!=NULL) pTx= (*pSym->func)(pTx); 

return pTx; 

} 

char *RunCommand(toDoList *pToDo, char *pTx) 
symTabEntry *pSym; 



} 



pSym= FindSymbol(pToDo->name); 
if(pSym==NULL) { 

pTx= SayErrortpToDo, UNDEF.SYMB, pTx); 

return pTx; 

} 

1f(pSym->func!=NULL) pTx= (*pSym->func)(pTx); 
else { 

pTx=SayError(pToDo, UNDEF_FUNC, pTx); 
return pTx; 

} 

return pTx; 



char *TxBuffer(void) 
{ 

static char buffer[Z80]; 
return buffer; 

} 

void WriteEeprom( symTabEntry *pSym, int type) 
{ 

if(type==INTEGER) printf( 

"\nTo EE, type: Xd off: %d val: %d\n", 
type, pSym->eeOffset, pSym->ival); 

return; 

} 

/* End of File */ 
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ROMLDR, an Embedded System 
Program Locator 



Charles 

MS-DOS software development tools such as C compilers and 
debuggers have become marvelously sophisticated and useful. 
They can also provide a cost-effective means for developing em- 
bedded systems. The purpose of this article is to introduce one of 
the aspects of using a high performance DOS-based C compiler 
for embedded systems, that of relocating code and data segments. 
I provide a program, ROMLDR, which can modify a program from 
the MS-DOS EXE format to a located binary file format. 

ROHLDR's principle purpose is to adapt DOS-based C compiler 
output for use in EPROM-based embedded systems. Other uses 
include BIOS extensions, EPROM-based MS-DOS applications, 
and relocation of MS-DOS programs in PC memory, such as 
above the 640k MS-DOS memory limit. ROMLDR can also be used 
with EXE files generated by languages other than C. 

ROMLDR was written using Borland C 3.1. It should be possible 
to use either Borland Turbo C or Microsoft C to make the ROMLDR 
program and to use for embedded programs. I have tested ROMLDR 
only with the Borland C 3. 1 compiler. 

Embedding DOS-Compiled Programs 

To use DOS-compiled programs in EPROM-based embedded 
systems, you must provide several additional components, as well 
as resolve some unique programming issues. A number of the re- 
quired components, such as the startup code, depend on the com- 



B. Allison 

piler, target hardware, and application. (See the sidebar "Coding 
for Embedded Applications" for a brief discussion on embedded 
code requirements.) 

Once you have attended to all these details, you can program, 
compile, and link the various program files into an MS-DOS EXE 
file. However, you can't just burn your EXE file into EPROM and 
go. You must explicitly perform a step that MS-DOS performs 
implicitly when it loads an EXE file. 

MS-DOS modifies programs with the EXE extent when it 
loads them into memory. This modification, often referred to as a 
fix up (also known as the locate function), consists of modifying 
the program's segment values for the actual memory address 
where it is to run. By performing fix ups, DOS can load an ex- 
ecutable almost anywhere in real-mode memory. (DOS can load 
small programs with the COM extent anywhere and run them 
without modification.) 

DOS performs fix ups by adding the file's load-address seg- 
ment value to all segment addresses stored in the code and data 
areas of the program. 

Unlike DOS programs, most embedded systems programs re- 
side in and execute from EPROM. Embedded system locators 
must perform fix ups prior to placing the program in EPROM and 
must take into account that variables will be located in RAM, 
through their initialized values for startup are still in EPROM. 
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Before I present my program in detail, I want to outline the 
major parts of the location process. I will first describe the struc- 
ture of a DOS EXE file, and how that structure is reflected in my 
code. Next, I will describe the location process. 

EXE File Format 

The EXE file consists of several sections, including a header, 
program code, data initialization values, and optional program de- 
bug information. Refer to structure EXE_HDR at the beginning of 
Listing 1 for the layout and definitions of the various parameters. 
The header section consists of several parameters which define the 
size of the file and the size of the header. Following these parame- 
ters is a section of fix-up far pointers. 

Each of these pointers targets a location in the program code 
containing a segment address value that must be modified with the 
correct load address. These pointers are stored in standard 80x86 
segment. offset format relative to the beginning of the code section. 
The pointers' segment values are derived from teh MAP file seg- 
ment table by using the top four hexadecimal digits from the be- 
ginning address listed for each segment. (MAP files are generated 
by the compiler. MAP file segments consist of the top four hexa- 
decimal digits of the beginning address.) 

There are num_reloc fix-up pointers in the header section. 
These pointers begin at the offset off_reloc from the beginning of 
the header. (Note that fix-up pointers may not be sorted by address as 
they occur in the EXE file.) Following the header is the program's 
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Listing 1 The EXE locator program 



I* ROMLDR.C EXE locator program 
written by: Charles B. Allison 
last change: 11-3-93 */ 

♦include <sys\stat.h> 
♦include <io.h> 
♦include <dos.h> 
♦include <stdio.h> 
♦include <stdlib.h> 
♦include <alloc.h> 
♦include <conio.h> 
♦include <ctype.h> 
♦include <fcntl.h> 
♦include <string.h> 
♦define BC 1 

/* BC is Borland c, else assume Microsoft */ 
typedef struct { 

unsigned si g; /* signature ■ 4d5ah */ 

unsigned lst_sec_lng; 

/♦length of last sector in file modulo 512*/ 

unsigned file_size; 

/* size of file in 512 byte pages includes hdr*/ 
unsigned num_reloc; 

/* number of relocation items */ 
unsigned hdr_siz; 

/* # of 16 byte paragraphs in header */ 
unsigned min_ld_para; 

/* min ♦ of paragraphs above load file */ 
unsigned max_ld_para; 

/* max ♦ of paragraphs requested by file */ 
unsigned disp_stack_seg; 

/* rel displacement of stack segment */ 
unsigned sp; 

/* contents of stack ptr on entry to prog */ 
unsigned chksm; /* check sum for file */ 
unsigned ip; /* beginning instruction ptr */ 
unsigned rel_cs_seg; I* relative cs segment */ 
unsigned off_reloc: 

/* offset to 1st relocation item typ. le */ 
unsigned overjay; /* overlay number */ 
unsigned rsrved; /* ?? reserved ?? */ 

/* relocation item format is seg:off location 
relative to the beginning of the code section */ 
} EXEJDR; 
struct HP_TBL { 
long addrs; /* segment beg. address */ 
long haddrs; /* segment high addrs*/ 
char class[12]; /* class of object */ 
} maptable[12»]; 

void sort_table(void); 
void gethdr(char *bf): 
long hexcvt(char * nun); 
size_t read_block(char far 
long read_segm(int i); 
size_t write_block(char far *segbuf ,size_t 
long write_segm(long segsize); 
int fix_segm(int i); 
int configtchar *cfgfile); 
void term_error(int numerr); 

unsigned (*ch_ptr)[2];/* pointer to translation table 

[0] = offset, [1] = segment*/ 
char mfile[14] = "rom.map"; /* dumy file names */ 
char bfile[14] = "rom.bin"; 
char efile[14] = "rom.exe"; 

/♦columns for starting and ending addresses in HAP */ 

♦define LCOL 1 
♦define HCOL 8 
♦ifdef BC 
♦define MAPCOL 41; 



segbuf,size_t segsz); 

segsz); 



The C Users Journal — March 1994 



/*bc map file class column*/ 
#else 

#def1ne HAPCOL 45; 

/*ms map file class column */ 

#endi f 

int classjoc = MAPCOL; 

FILE *mapfile,*exefile,*binfile; 

#define BUFJIZE 60 

char mapstring[BUF_SIZE]; 

long fsize; /*number of bytes in exe file */ 

int nsegs; /* number of segments in map */ 

unsigned romsadr = 0xf000,ramsadr=0x40; 

char header[10000]; 

EXEJDR *filhdr = (EXEJDR *)header; 

char far *seg_buffer; 

int next_fix = 0; 

char ram_class[15] = "FARJJATA"; 

unsigned ramdata; /* beginning ram segment*/ 



************* * 



/* ************ 
int maintint argc.char *argv[]) 
{ 

int r_class_flag=l,i ; 
long tmp.ssize: 



if((segjiuffer = (char far *) farmalloc(0xl0000D) 

NULL) term_error(0); 
iftargc == 1) term_error(-l); /*any cfg file name? */ 
config(argv[l])i 
i=0; 

while (fgets(mapstring,BuF_SIZE,mapfile)) 
{ 

/* process map file from mapstring input */ 
/* maptable[l] - n contains the segments - 
class STACK should be last one */ 
/* ends with i having n+1 segments */ 
if( (int)strlen(mapstring) > classjoc+l) 
{ /* get rid of \n at end of string */ 
mapstring[(int)strlen(mapstring)-l]='\0' ; 
if((tmp = hexcvt(&mapstring[LCOL])) >= 0) 
{ 

maptable[i].addrs = tup; 
maptablefi ] . haddrs=hexcvt(&mapstri ng[HC0L] ) ; 
&mapstring[classj oc]) ; 
strcpy(maptable[i]. class, 

imapstringfclassjoc]); 
if(r_class_flag) 

if(strcmp(&mapstnng[classJoc],ram_class)==0) 
{ /*set it to first class occurance*/ 
ramdata = (maptable[i].addrs) »4; 
r_class_flag = 0; 

} 

printf("\n Segment %4. 41 x Class Us", 
maptable[i].addrs/16,maptable[i]. class); 
i++; 

}/* end - if hexcvt */ 
} /* end if strlen */ 
if(i>=119) break; /* error too many segments */ 
} /* end while */ 
if(feoftmapfile)) 

printf("\nend of file\n"); 
else 

printf("\nerror reading map file\n"); 
nsegs = i-1; /* number of segments [1 to nsegs] */ 
gethdrt header); /* read in the exe header info */ 
/* size of object section of file */ 
fsize = (long) (C512L * (filhdr->file_size-D) + 

filhdr->lst_sec_lng - 16L * filhdr->hdr_siz); 
printf("\nStartup Address %4.4x:M.4x\n",romsadr+ 

fi lhdr->rel_cs_seg ,f i 1 hdr->i p) ; 
printfC'Rom Size %1 x\n" , fsize); 
/* process the exe file header - sort fix ups */ 
sort_table(); 

/* read in exe file by segment 
do fixups from map table and 



write it to output file */ 
for(i=0;i < nsegs;H+) 

{ 

if((ssize = read_segm(i )) > 0L ) 

{ /* ignore length segments */ 
fix_segm(i ); 
write_segm(ssize ); 

} 

} 

/* done - end the program */ 

farfree(seg_buffer); 

fcloseallO; 

return 0; 

} 

[* ****************** */ 

/* qsort routine for far pointers */ 

int cmp_ptr(const void *a, const void *b) 

{ 

long vala.valb; 

vala=((long)((unsigned *)a)[0])+ 

(((unsigned *)a)[l]«4); 

valb=((long)( (unsigned *)b)[0])+ 

(((unsigned *)b)[l]«4); 

vala -= valb; 

if(vala < 0) return -1; 

iftvala > 0) return 1; 

return 0; 

) 



_____ 
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ROMLDR, an Embedded System Program Locator 



Charles B. Allison 



code section. This section consists of one or more separate seg- 
ments, the number and type of which depend on the program and 
its memory model. Following the code is the initialized data sec- 
tion. Then comes the uninitialized data section, and finally the 
stack. 

The Location Process 

Once it has loaded a program into memory, the MS-DOS 
loader adds the code section's segment address to the segment 
value stored in each location requiring a fix up. The loader finds 
these locations by dereferencing each fix-up pointer in the header. 
MS-DOS sets the CPU's stack registers to disp_stdck_seg:sp and 
calls the program at address rel_cs_seg:ip. (Note: For the sake of 
illustration, I use disp_stack_seg, sp, rel_cs_seg, and ip to repre- 
sent values stored at specific offsets within the EXE header. By 
referring to fields of the same name in my struct, EXE_HDR, you 
can see where these values are stored in the header.) MS-DOS 
also provides some environment and header information to the 
loaded program through register contents. 

Most, but not quite all of the information necessary to generate 
rommable absolute binary files already exists in the EXE file. The 
rest of the information must come from the segment data in the 
compiler's MAP file and from configuration information provided 
by the user in a loader configuration file. 

Program Description 

ROMLDR uses the linked EXE file and its MAP file to create a 
binary file that can be programmed into EPROMs. 
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I* sort_table */ 

/* sort header table */ 
void sort_table(void) 
{ 

qsortdvoid *)&header[filhdr->off_reloc], 
filhdr->num_reloc,4,cmp_ptr); 

} 

/* read_block */ 

size_t read_block(char far *segbuf,size_t segsz) 
{ 

if(fread(segbuf ,1, segsz, exefile) != segsz) 

tern_error(-7); 
return segsz; 
} 

/* read_segm */ 

long read_segm(int i) 
{ 

long segsize; 

segsize ■ maptable[i].haddrs - maptable[i].addrs; 
if(lsegsize) return 0; 

segsize += maptable[i+l].addrs-(maptable[i].haddrs); 
iftsegsize <= 0x8000) 

{ read_bl ock( seg_buff er , ( si ze_t Jsegsi ze ) ; 

} else { 

read_block(seg_buffer, 0x8000); 
read_block((&seg_buffer[0x8000]), 
(size_t) (segsize- 0x8000)); 

} 

return segsize; 
} 

/* --- write_block */ 

size_t write_block(char far *segbuf ,size_t segsz) 
{ 

if(fwrite(segbuf,l, segsz, binfile) != segsz) 

term_error(-8); 
return segsz; 

} 

/* write_segm */ 

long write_segm(long segsize) 
{ 

if(lsegsize) return 0; 
ifCsegsize <= 0x8000) 

{ write_block(seg_buffer, segsize); 

) else { 

write_block(seg_buffer, 0x8000); 
write_bl ock( (&seg_buff er[0x80OO] ) , 
(size_t)(segsize-0x8000)); 

} 

return segsize; 
} 

/* fix_segm */ 

int fix_segm(int i) 
{ 

unsigned tmp.cseg.fixup; 

unsigned far * fixptr; 

cseg = (unsigned) (maptabl e[i] .addrs/16L) ; 

while(next_fix < fi lhdr->num_reloc) 

{ 

if(ch_ptr[next_fix][l] > cseg) break; 
tmp = ch_ptr[next_fix][0]; /*offset into buffer*/ 
fixptr = (unsigned far *) &seg_buffer[tmp]; 
fixup = *fixptr; 
/* modify segment fixup according to type */ 
if (fixup >= ramdata) 
{/* modify for ram */ 
fixup -= ramdata; 
fixup += ramsadr; 

} 

else 

{/* handle as rom */ 
fixup += romsadr; 

} 
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within the Borland IDE, I had to reduce the buffer's size significantly 
due to memory constraints.) A simple error routine, term_error, 
generates error messages for a variety of potential problems, and 
provides for program termination. 

After allocating a buffer, ROMLDR reads the configuration file 
(CFG) specified on the command line. This file contains the names 
for the EXE, MAP, and BIN output files, EPROM and RAM hexa- 
decimal load addresses, and the class name of the first RAM seg- 
ment. Table 1 shows the CFG file format. CFG file parameters 
must be located on separate lines and separated by spaces. On 
each line, ROMLDR ignores any characters occurring after the list of 
required parameters. 

Reading the MAP File 

ROMLDR executes a while loop to read and process lines of text 
from the MAP file. (The MAP file used with ROMLDR should be the 
short version, which contains only the segment table.) ROMLDR ex- 
tracts memory allocation class names, plus their starting and end- 
ing addresses, and stores them in an array of structures called map- 
table. ROMLDR performs a simple length check using configuration 
variable class_loc to determine if the current line contains seg- 
ment information. ROMLDR expects the line to be in a fixed column 
format, with the class name occurring at offset class_loc. ROMLDR 
converts address values to long integers, and compares class names 
with ram_class, a configuration variable used to define the beginning 
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*f ixptr = fixup; 

next_fix++ ; 
} /*end while */ 
return ; 
1 

/* hexevt */ 

/* do hex digits to unsigned long */ 

long hexcvtCchar * num) 

{ 

char *term; 
long value; 

value = strtoul(num,&tern,,16): 
return value; 

1 

/* gethdr */ 

void gethdrtchar *buf ) 
{ 

int i.j=32; /*index counter */ 

if(fread(Sbuf[0],l,32,exefile) < 32) 
term_error(-6); 
/* have filhdr contents so get size of full header */ 
if(fread(&buf[j],16,filhdr->hdr_siz-2,exefile) 

< filhdr->hdr_siz-2) term_error(-6); 
(unsigned *)ch_ptr = 

(unsigned *) (&buf [fi lhdr->of f_reloc] ) ; 
/* get address of relocation table - ch_ptr [n][m] 
m - offset, 1 - seg, n relocation # */ 

1 

/* config */ 

/* get configuration data */ 
int config(char *cfgfile) 

{ 

FILE *cfg; 
char buf[80]; 

if((cfg = fopen(cfgfile,"r"))==NULL) term_error(-l) ; 
if(fgets(buf,80,cfg) == NULL) term_error(-2); 
if(sscanf(buf,"J>s %s Is". Unfile, 

Sefile, ibfile) != 3) term_error(-2); 
/* Now try to open input file 1 */ 
i f ( (mapf i le=f open (mf i 1 e , "r" ) ) ==NULL ) term_er ror( -3 ) 
if((exefile=fopen(efile,"rb"))==NULL) term_error( -4) 
if((binfile=fopen(bfile,"wb"))==NULL) term_error(-5) 
if(fgets(buf,80.cfg) == NULL) term_error(-7); 
i f ( ss ca nf ( b uf , " !Wx X4x" , & roms ad r , 

Sramsadr) != 2) term_error(-7); 
if(fgets(buf,80,cfg) == NULL) term_error(-7); 
if(sscanf(buf,")!s",&ram_class) != 1) term_error(-7); 
return 0; 
} 

/* error handler */ 
char *errlist[10] = { 
"Memory Allocation Error", 

"No configuration file, USAGE: romldr cfgfi le.cfg", 
"Configuration file error - File names", II -I 
"Map File open error", I/-3 
"Exe File open error", //-4 
"Bin File open error", //-5 
"Error reading header", //-6 
"Error reading exe file", 1 7-7 
"Error writing bin file", //-8 

}; 

void term_error(int errnum) 
{ 

errnum = abs(errnum); 

if( errnum >= 9) exit(-l); 

printf("J.s\n",errlist[errnum]); 

farfree(seg_buffer) ; 

exit(errnum); 

} 

/* End of File */ 
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of RAM. The beginning segment address 
is stored in ramdata. ROMLDR currently will 
process a maximum of 120 segments. 



Processing the Header 

Once ROMLDR has acquired the MAP 
file, it reads the EXE header portion via 
function gethdr. This function first reads 



Table 1 CFG file format 


Mapfile Exefile Binfile 


II filenames with no path 


R0M_Address RAM_address 


// 4 digit hex addresses [0...9,a...f] 


Ram_Class 


// name for first RAM segment 



One source is all you 
really need. 
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in 32 bytes of the header to determine the 
header's size and then loads the rest of the 
header. This function stores header infor- 
mation in an array named header which 
can contain a maximum of 10,000 bytes. 

ROMLDR then sorts the fix-up pointers 
into ascending address order. Function 
sort_table uses qsort to sort the pointers. 
Function cap _ptr, supplied as an argument 
to qsort, compares values for qsort by 
converting pointers from segment: offset to 
long integer form. 

After sorting the pointers, ROMLDR per- 
forms fix ups on each segment, using a 
for loop to iterate through all segments. 
Function read_segm reads each segment 
from the EXE file and returns the segment 
size. If the segment length is non-zero, 
ROMLDR calls function fix_segm to run 
through any fix ups needed for the seg- 
ment and then calls write_segm to output 
the processed segment to the BIN file. (A 
logical enhancement to ROMLDR would be 
to output the segments in a standard hex 
format, such as Intel hex format.) 

How ROMLDR Handles 
EPROM and RAM 

EPROM segments require different 
modifications than RAM segments. ROMLDR 
treats all segments at or below the class 
named ENDC0DE as EPROM and treats 
those above ENDC0DE as RAM. The lo- 
cation process currently terminates on 
reaching the last segment, the STACK 
class. (The BIN file, however, needs only 



Listing 2 Sample program that 
produces segment classes 

OEMO.C 

/* Test Program for Rom Loader */ 
/* Large model with some far data*/ 
#include <conio.h> 
#include <dos.h> 

char msg[15] = "Hello World\n\r"; 
int locint; 

int directvideo=l; /*BC direct to hw*/ 

int far test; 

int far test2=0x55aa; 

int far * tptr = &test; 

void main(void) 
{ 

int far * ptr2 = itest; 
test = 0x1111; 
locint = test+1; 
cputs(msg); 

} 

/* End of File */ 
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to contain code and data segments up to 
the last initialized data value.) 

The ENDCODE class name is special for 
another reason. ROM based systems typi- 
cally must transfer initialized data from 
EPROM to RAM. Therefore, ROMLDR will 
modify all references to data segments to 
refer to the RAM locations and not to the 
initial values located in the EPROM. (The 
location for the initial values must be used 
in the startup code so that they can be 
transferred to RAM.) Segment ENDCODE is 
used for this purpose. I make the ENDCODE 
segment's length less than 16 bytes, locate 
it on a paragraph boundary, and ensure 
that the beginning data segment is also 
aligned by paragraph. As a result, the be- 
ginning ROM location for initialized data 
becomes ENDCODE+1. Since ENDCODE's ad- 
dress is less than the beginning of the 
RAM segment, it will refer to the ROM 
address just below the initialized data val- 
ues. 



ROMLDR modifies EPROM data by adding 
the configuration file's EPROM segment ad- 
dress, stored in romsddr, to the code's existing 
segment value. (A more sophisticated version 
of the program could offer the option of sev- 
eral user-defined addresses and the names of 
the classes that would reside in each.) 

ROMLDR modifies RAM segments by 
first subtracting out the value of the first 
RAM segment and then adding the con- 
figuration file's RAM segment location 
value. This method allows the RAM loca- 
tions to begin at the configuration-defined 
starting value. The subtraction was not 
necessary for code segments since they 
began with a zero segment value. 



Example Code 



Listing 2 is DEMO.C, a typical "Hello 
World" program with some added items to 
provide examples of values for several 
segment classes. Listing 3, DEMO. MAP, is the 
map file generated for DEMO.C using the 
example startup code in Listing 4 instead 



Coding for 
Embedded Applications 



Writing embedded systems appli- 
cations requires special efforts on the 
part of the programmer, because of 
how these applications differ from 
non-embedded applications. First, an 
embedded program that crashes can 
cause damage or injury, while a non- 
embedded program (e.g. a word proc- 
essor) may cause only a certain 
amount of user frustration. Embedded 
systems must handle the conceivable 
problems in stride and effectively re- 
cover from the inconceivable without 
help from users. 

Second, there are several special 
aspects to embedded code. Many em- 
bedded systems run standalone pro- 
grams without the support of complete 
operating systems such as MS-DOS, 
so these programs must take control of 
relevant interrupt vectors (including 
error conditions such as divide by 
and the Non-Maskable Interrupt). For 
these standalone programs, both the 



hardware and the program may require 
setup code. Programs compiled to run 
under MS-DOS contain startup and 
termination code to accept control 
from and return control to the operat- 
ing system. Standard library functions 
that don't access MS-DOS under nor- 
mal conditions may contain error-han- 
dling code that does access MS-DOS 
or that would terminate the program in 
an unacceptable fashion within an em- 
bedded system. In addition, some pro- 
grams may attempt to access non-disk 
MS-DOS functions, such as those used 
to modify interrupt vectors. If you port 
such programs to an embedded system, 
you must provide code to perform 
equivalent functions within the embed- 
ded system operating environment. An 
embedded program must start (or restart) 
in a known state. Since the program 
cannot obtain state information from a 
command line, it must find initial state 
data in EPROM. □ 
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DEMO. MAP 








Start 


Stop 


Length 


Name 


Class 


00000H 


00000H 


00000H 


ROMSTART BEG 


CODE 


00000H 


00E8FH 


00E90H 


TEXT 


CODE 


0CE90H 


00EC9H 


0003AH 


DEMO TEXT 


CODE 


00ED0H 


00ED5H 


00006H 


ENDCODE 


ENDCODE 


00EE0H 


00EE0M 


00000H 


I DATA BEG 


IDATA BEG 


00EE0H 


00EE0H 


00000H 


FARDATA 


FAR DATA 


00EE0H 


00EE3H 


00004H 


DEM05 DATA 


FAR DATA 


00EF0H 


00FB9H 


000CAH 


DATA 


DATA 


00FBAH 


00FBBH 


00002H 


CVTSEG 


DATA 


00FBCH 


00FC1H 


00006H 


SCNSEG 


DATA 


00FC2H 


00FC2H 


00000H 


CONST 


CONST 


00FC2H 


00FC7H 


00006H 


INIT 


INITDATA 


00FC8H 


00FC8H 


00000H 


INITEND 


INITDATA 


00FC8H 


00FC8H 


00000H 


EXIT 


EXITOATA 


00FC8H 


00FC8H 


00000H 


EXITEND 


EXITDATA 


00FD0H 


00FD0H 


00000H 


I DATA END 


IDATA END 


00FD0H 


00FD0H 


00000H 


UDATAJEG 


UDATAJEG 


00FD0H 


00FD1H 


00002H 


BSS 


BSS 


00FD2H 


00FD2H 


00000H 


BSSEND 


BSSEND 


00FE0H 


02FDFH 


02000H 


STACK 


STACK 


02FE0H 


02FE0H 


00000H 


UDATA END 


iinATA run 
UUAI A_LNU 


Program 


entry point at 0000:0000 





Listing 4 An example of startup code 



NAME ROMSTART_TEXT 

example startup code for 
imbedded systems use 

segment classes 
High addrs (rom) 
'BOOT' 



'CODE' 
ram 

'STACK' 
'BSS' 
'CONST' 
'DATA' 



_TEXT segment 



UDATAJND segment 

IDATA_END and UDATAJEG segments 



IDATA JEG segment 



Rename object file output to cOx.obj 
where x = S.C.M.L, or H 
and locate in project subdirectory 
Memory model selection set to 1 all others 

SMALLM EQU 
COMPACTM EQU 
MEDIUMM EQU 
LARGEM EQU 1 
HUGEM EQU 



STACKJIZE 
acrtused 



EQU 1000H 
equ 1 



;set desired stack size 
; satisfy external reference 



PUBLIC _acrtused 



DGROUP GROUP IDATA JEG, JATA, CONST, IDATA JND,\ 
UDATAJEG. JSS. STACK, UDATAJND 



; this segment marks beginning of rom code 
ROMSTARTJEG SEGMENT BYTE 'CODE" 
ROMSTARTJEG ENDS 



IF SMALLM OR COMPACTM 
JEXT SEGMENT BYTE PUBLIC 

EXTRN _main:NEAR 
ASSUME CS: TEXT 



CODE' 
;main program 



ENDIF 

IF MEDIUMM OR LARGEM OR HUGEM 

EXTRN _main:FAR ;main c program 

JEXT SEGMENT BYTE PUBLIC 'CODE' 
ASSUME CS:JEXT 

ENDIF 



ASSUME DS:DGR0UP, 
PUBLIC start 



SS: DGROUP 



start 
cli 
eld 



PROC NEAR 



******************************** ****** ****** 



do hardware initialization and ram check 



PUBLIC init_ram 
nit_ram: 

'k'k'k'k'k'k'k'klrk 

transfer initialize data from rom to ram 



;data to init. 



MOV BX, SEG I DATA J EG 

MOV AX, SEG IDATAJND 

sub ax.bx 

mov cl,3 

shl ax.cl 

mov ex. ax 

jcxz no_initJata 



: address of frame # in rom 

mov ax, seg ENDCODE ineeded for jbromldr 

inc ax ;ram init values begin at 

mov ds.ax ;segment ENDCODE + 1 

mov si .0 
; address of frame # in ram 

mov ax, seg I DATA J EG 

mov es.ax 

mov di.0 

; initialize data and const segments 
rep movsw ;word transfer 
no_initJata: 

mov bx, seg UDATAJEG ;clear bss data 

mov ax, seg UDATAJND 

sub ax, bx 

mov cl ,3 

shl ax.cl 

mov cx.ax 

jcxz no_zerodata 

mov es.bx 

mov di,0 

mov ax,0 
rep stosw 

PUBLIC no_zerodata 
no_zerodata: 

mov ax, DGROUP ; set up stack 

mov ds.ax 

mov ss.ax 

mov sp. OFFSET DGROUP: STACKJOP 
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of the standard Borland startup code. Note that the _INIT_ seg- 
ment contains some values which are addresses of library initiali- 
zation routines that should be called in order of priority. The ex- 
ample startup code does not yet include this section or the inter- 



ROMLDR, an Embedded System Program Locator 

rupt vector initialization section. Examples of these can be found 
in your compiler's startup code. The sidebar "Startup Code for 
Embedded Systems" provides a discussion of startup code require- 
ments. 



Startup Code for Embedded Systems 



Startup code consists of code to setup and to terminate 
an application program. Startup code is typically written in 
assembly language and the source code is sometimes pro- 
vided with the C compiler. Replacement libraries often in- 
clude replacement startup code that can be used when the 
normal C compiler library functions are not used. 

Startup code for EPROM-based systems must provide 
additional functionality which depends on the specifics of 
the system. 

Embedded system startup code usually performs the fol- 
lowing steps: 

1. Establish order of segment classes. 

2. Set up the program stack. 

3. Transfer initialized values to RAM from EPROM. 

4. Zero uninitialized RAM values. 

5. Set up error interrupt vectors. 

6. Call necessary library initialization routines. 

7. Call the application. 

The startup code must also provide the following com- 
ponents: 

8. Error shut-down code to terminate or restart. 

9. Exit shut-down code to terminate or restart. 

10. Any error and miscellaneous routines. 

11. Initialization of application before calling main function. 

12. A reset vector for standalone applications. 

There are two approaches to creating a custom startup 
module. You can start with the original library or compiler 
code and modify it to handle the added embedded require- 
ments, or you can start with a minimal embedded system 
startup module and extend it as required. 

Custom startup code may not provide all features de- 
scribed in a compiler's documentation. Environment, argv 
and argc, and even common option variables may not be 
implemented. For example, Borland C allows you to set 
stack size by initializing a far variable, _stklen. This vari- 
able is created by the Borland startup code and may be re- 
placed in custom startup code by a simple stack-size defini- 
tion. 

Startup code defines segments and segment classes and 
their order. While compilers often allow these names to be 



changed for modules, the compiled libraries are still expect- 
ing certain module names to exist. Warnings abound over 
changing the basic segment order so extreme care should be 
used if that appears to be necessary. The addition of seg- 
ments and classes is much less critical. As shown in Listing 
4, you can even add them virtually to make the MAP more 
descriptive. 

Listing 4 is a simple example of startup code. I provide 
it as a template rather than a complete example since some 
portions are compiler dependent. You may still need to add 
several code sections for an application. Refer to your com- 
piler's startup code module for specific details. □ 
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ROMLDR Versus Commercial Products 

ROMLDR has several shortcomings when compared to commer- 
cial locator packages. When you use ROMLDR you must provide 
startup code for your application; commercial products usually 
provide the basic startup code required as well as code solutions 
for a variety of problems which must be overcome in various em- 
bedded configurations. ROMLDR does not provide debugging sup- 
port, but commercial products usually provide some capabilities 
for the debugging of application programs. Finally, vendors of 
commercial locator packages often provide technical support; 
when you use a non-commercial package such as ROMLDR you must 
solve all problems on your own. 



Listing 4 continued 



Charles B. Allison 

Conclusions 

While ROMLDR is intended primarily as a learning tool and an 
introduction to embedded systems, it can prove useful for some 
low-end applications. ROMLDR should be able to handle straightfor- 
ward applications where there is one EPROM and one RAM memory 
space. It can easily be modified for more complex configurations, 
especially those which have specific fixed requirements. 

Embedded systems often monitor and control equipment other 
than normal computer peripherals. Embedded systems program- 
mers must be extra cautious, since bugs in their programs can 
place property and lives at risk. In this situation, there is no substi- 
tute for understanding both the application and the tools. Under- 
standing how ROMLDR works may give you insight into how more 
complex systems operate. □ 



******************** ** ** ** ** ** ** ** ** ** ****** * 

add code to: 

1) initialize INITDATA Functions (see cO.asm) 

2) capture interrupt vectors 8-4 

sti ;enable interrupts 

call jnain ;enter main program 

add code to: 

1) shut down EXITDATA Functions 

2) handle shutdown errors 

3) prepare to restart 

jmp start 
start ENDP 

_abort PROC DIST 

PUBLIC _abort 
;handle error abort 

jmp start 
_abort ENDP 
IF SMALLH OR COMPACTM 
_TEXT ENDS 
ENDIF 

IF MEDIUHH OR LARGEM OR HUGEM 

_TEXT ENDS 

ENDIF 

; segment marks end of rom code 
;make it non zero, length < 16 bytes 
ENDCODE SEGMENT PARA PUBLIC 'ENDCODE' 

db "ENDROM" ;seg ENDCODE+1 = begin ram 
ENDCODE ENDS 



beginning of dgroup and initialized data in ram 

IDATAJEG SEGMENT PARA PUBLIC ' IDATA_BEG' 
IDATAJEG ENDS 

_FARDATA SEGMENT PARA PUBLIC 'FARJATA' 
_FARDATA ENDS 

_DATA SEGMENT PARA PUBLIC 'DATA' 
_DATA ENDS 

_CVTSEG SEGMENT WORD PUBLIC 'DATA' 
PUBLIC _RealCvtVector 

RealCvtVector label word 

_CVTSEG ENDS 

_SCNSEG SEGMENT WORD PUBLIC 'DATA' 
_SCNSEG ENDS 



CONST 
CONST 



SEGMENT WORD PUBLIC 'CONST' 
ENDS 



_INIT_ SEGMENT WORD PUBLIC 'INITDATA' 
_INIT_ ENDS 

_INITEND_ SEGMENT WORD PUBLIC 'INITDATA' 
_INITEND_ ENDS 

_EXIT_ SEGMENT WORD PUBLIC 'EXITDATA' 
_EXIT_ ENDS 

_EXITEND_ SEGMENT WORD PUBLIC 'EXITDATA' 
_EXITEND_ ENDS 

IDATAJND SEGMENT PARA PUBLIC 'IDATA_END' 
IDATAJND ENDS 

; end of initialized data 

UDATAJEG SEGMENT WORD PUBLIC 'UDATA_BEG' 
UDATAJEG ENDS 

JSSSEGMENT WORD PUBLIC 'BSS' 
JSSENDS 

JSSEND SEGMENT BYTE PUBLIC 'BSSEND' 
_BSSEND ENDS 

STACK SEGMENT PARA STACK 'STACK' 
DW STACK_SIZE DUP (?) 

STACKJOP LABEL WORD 
STACK ENDS 

; end of initialized segment in ram 
UDATAJND SEGMENT WORD PUBLIC 'UDATA.END' 
UDATA_END ENDS 
bootstrap address for powerup reset 
far jump to program beginning 
may have to be manually placed in EPROM 
BOOTSTRAP SEGMENT AT 0FFFFH 
JMP FAR PTR start 

BOOTSTRAP ENDS 
end start 

End of File 
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Background 

The developer of a control system desires a well-behaved sys- 
tem that is stable throughout the operating spectrum. In the proc- 
ess of designing and debugging the controller, operating regions 
that exhibit oscillatory or unstable operation are avoided. Non- 
linearities are typically modeled using a series of discrete equa- 
tions developed for the system. 

A PID or Proportional Integral Differential controller is an ex- 
ample of a closed-loop system. Implemented discretely, it would 
compute at z intervals: 

T(z) = T(z-l) + K k * (E(z) - E(z-D) 

+ Ki * E(z) + K d * E(z-2) * (1 + E(z-l)) 

In this linear example, the z sampled periods for the controller repre- 
sent discrete time samples and Kk, K u and Kd are constants. A non- 
linear system designer might attempt to modify Kk, Ki, and Kd as a 
function of input E(zl This of course would require Kk(z), K(z), and 
Kd(z) (and possibly Kw(z-1, z-2, ... z-n) etc). The designer would 
compute stability and phase margin in a continuous system and con- 
vert these to the discrete world using a Discrete Transform. 



After the analysis the designer would proceed to code T(z) into 
assembler or C and port it to a target. This article describes how to 
implement a simple fuzzy-logic based servo controller in the C pro- 
gramming language. C language portability allows the controller 
to run in either a micro-controller based environment or on a PC. 

Escaping Brittleness 

Brittleness is the bane of the control-system designer. A brittle 
system is one which "breaks" easily. For example, in the coding 
of T(z), we defined the output T(z) to be an eight-bit unsigned 
char that follows the eight-bit radix of our A/D converter. Sup- 
pose that several of the terms of T(z) were discreetly nine or ten 
bits. The result could be truncated and thus produce incorrect out- 
put when T(z) was cast to an unsigned char. We must check over- 
flow after every operation of T(z) and perform corrective logical 
operations. 

Besides the implementation issues, PID and PI suffer from 
some serious real-world problems. In controls, non-linearities are 
the rule. Factors such as friction and temperature affect the behav- 
ior of systems. What appears to be stable under one set of condi- 
tions yields poor performance under another. 




Since receiving a BSEE from UC Berkeley, Jack J. McCauley has been working as a Software Engineering Consultant. His specialty is 
real-time systems with an emphasis on servo controls and signal processing. He can be reached at (510) 531-1581. 
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Figure 1 Fuzzy set for temperature 
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There are techniques for dealing with changes. One possibility 
is to sliding-mode modify the PI gain parameters. Experience with 
this approach has shown that it works very well so long as the 
inputs are bounded properly. Current thinking, however, indicates 
that the amount of time invested in developing this approach will 
not be extracted in performance. What most people do to deal 
with non-linearities is to add a bunch of testing and branching 
code to deal with the caveats. In most PID, PI closed-loop sys- 
tems, it ends up that the majority of the code is dedicated to deal- 
ing with these anomalies. 

Fuzzy Logic 

Fuzzy logic holds promise as a means of handling control-sys- 
tem non-linearities. It provides a unique way of looking at control 



Figure 2 Feedback configuration of a typical torque servo 
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Figure 3 Fuzzy plant for torque servo 
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problems. The control problem is described as a rale base, with a 
rule input matrix \i(T) and a corresponding output function for that 
rule. When few rales are to be evaluated, simple linguistic rales 
can be substituted instead. 

One might imagine a fuzzy set \i(T) that describes the outside 
temperature as "very cold," "cold," "warm," and "hot." The four 
members of \i(T) are linguistic operators that represent the human 
inferred description of the space representation of each member of 
[i(T). The membership function is typically a trapezoid that repre- 
sents a degree of membership. The degree of membership is a real 
number between 0.0 and 1.0 with a degree of 1.0 meaning full 
membership and a degree of 0.0 indicating 
no membership. (See Figure 1.) 

Suppose the outside temperature is -50 F. 
Then according to \i(T) the outside tempera- 
ture will lie in the domain of "very cold." If 
the temperature is 12 F, the temperature 
might not be so much "very cold" as it is just 
"cold." Membership functions almost always 
overlap in the domain of \u[T). Fuzzy logic 
provides a means of dealing with overlap- 
ping domains and also domains of overlap- 
ping output sets. The math allows us to 
weigh the cumulative effect of all rales to 
generate a crisp output. A crisp output is 
also called a de-fuzzified output. 

The typical fuzzy plant (controller) 
consists of one or more input fuzzy sets, a 
rale base, and an output fuzzy set. The in- 
put sets fuzzify using the rale base, and the 
output set de-fuzzifies from the inputs, 
rales, and the output de-fuzzifier function. 



Tann — Anotorfz) * Km.o\at(z) 

sensed on the motor shaft. (See Figure 2.) 

The eight-bit PWM applies a positive voltage to the terminals 
if the PWM value is between 128 and 255. A negative voltage is 
applied if the value is between and 126. An eight-bit A/D con- 
verter and pre-amp sense the feedback torque. The granularity of 
the feedback torque is determined by the radix of an eight-bit A/D 
converter. An eight-bit D/A (PWM) assures coherency between 
conversion radixes on the input. (See Figure 3.) 
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An Application 

This two-input controller is a torque 
regulator on a DC motor. The controller 
topology could easily be extended to any 
two-input, single-output fuzzy controller. 

We desire to regulate the torque ap- 
plied to the shaft of a permanent-magnet 
DC brush motor. The torque r mo tor applied 
to the shaft is a linear function of armature 
current /motor and (to a lesser extent which 
will be ignored here) motor temperature. 
Armature current is controlled by a Pulse 
Width Modulated (PWM) amplifier which 
varies the duty cycle DA from to 100 per 
cent as a linear function of input voltage. 

If a positive voltage is applied to the 
motor terminals, a positive torque will be 
applied to the motor shaft. If a negative 
voltage is applied, a negative torque will 
be applied to the motor shaft. The job of 
the servo is to regulate the torque on the 
motor shaft under varying load conditions. 
The servo applies an adjustment to DA 
based on the commanded torque input, 
7cmd(z), and the feedback torque input: 



Run your existing C functions with few or no 
changes as concurrent threads! Only C/Tasker lets 
you work in pure, standard C and freely use any 
standard library function or DOS call. Build high- 
performance multi-line serial apps. (e.g., one thread 
per channel). Features: semaphores, event, 
message queues, critical sections and much more. 
No re-entrancy problems with DOS or any C 
function. Ready-to-complile on-disk sample source 
code. See more than 1 ,000 threads run with our 
free demo (source code included). Run Turbo 
Vision as a thread and spawn more threads from 
within it! Real-time support: ISRs may resume 
suspended threads. Blindingly ^ _ _ _ 
fast scheduler, designed for 24^f 
use in commercial-quality 
applications. Compatible with Borland, Microsoft 
and Symantec C, Turbo Debugger, Codeview, BGI, 
floating point emulators, 80x87. 
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DEL (Data Encryption Library) is a high-speed 
toolkit that lets you encrypt/decrypt data in C, C++ 
and Clipper. It includes: a software-only, cipher- 
feedback DES engine; a high-performance FastDES 
mode; an ultra-fast Turbo mode; and blazing-speed 
CRC-16 and CRC-32 routines. The library is DOS 
and Windows compatible, ^ 
and is supplied in both 11 9 

.LIB and .DLL formats. , for soufce , add $wo) 
Compatible with Borland, 
Microsoft and Symantec C/C++ and Clipper. Full 
source code available. 



C/TASKER PLUS 

One step ahead of the crowd 



C/Tasker PLUS includes every feature of C/Tasker 
and adds full source code and the Task Driver 
Toolkit, an exclusive concept for the creation of new 
multitasking facilities (installable services). With 
Task Drivers, you work with a solid API to build 
your own multitasking primitives (e.g. IPX/NETBIOS 
network communication functions that your threads 
may use to establish non-blocking, concurrent 
peer-to-peer ^ 



communications over the 
network). An interrupt- (only S749 when 

driven serial apgrading from 

communication Task Driver c/Tasker) 

is included and may be used as is, or as a basis for 

further development. 



TURBOWORD 

The word processor toolkit for C 



TurboWord is a full-blown word processor / text 
editor library that may be linked to your programs. 
Customize it anyway you like; the proposed 
command dispatcher is WordStar-like. Features: 
dynamic wordwrap; horizontal scroll; fast 
background printing; search/replace with options; 
hyphenation; block ops; undo; 
bold/italics/underline; dotted 
commands; and more. 
Extremely compact and fast. Of 
course, as a C/Tasker-compatible library, it may run 
concurrently with your threads. May work in a 
window without disturbing the rest of the screen. 
Full source code is included. 



For info and technical support, contact: 

North and South America: ESC, 913-832-2070; 

Fax: 913-832-8787; CompuServe: 71 141 ,3624 
Elsewhere: Microware sas, Italy, +39-6-3332744; 
Fax: +39-6-3336465; e-mail: mc6388@mclink.it 
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Fuzzy Controller for Torque 

The fuzzy controller is implemented in C on an inexpensive 
high-integration micro-controller. A simulation program executes 
on a PC-AT, to assist debugging of the fuzzy servo prior to port- 
ing it to the micro-controller. 

In this system the fuzzy plant is a two-input, single-output con- 
troller. Three fuzzy sets exist with the input sets occupying two 
dimensions of the rule base and the output set occupying the ac- 
tion to be performed on each rule, which is the combination 
pointed to by the input fuzzy set membership functions. 

The first input fuzzy variable Terror is the error between the 
setpoint or command torque at time t, and the feedback torque or: 

TerrorfzJ = T C md(z) - Tarm(z) 

The second input dTtnotldt is the "rate of change of error" or 
how quickly the feedback torque at time t is changing with respect 
to the previous sample at time f-1: 

dT m (z)/dt = TannCz; - T^z-l) 



The output function \i(DA) detenriines the action to be per- 
formed upon evaluation of the rules. For example, if the instanta- 
neous feedback torque is at the setpoint: 

r C md(z) - UzJ 

but the feedback torque derivative is non-zero: 

Tarmiz) > T^fz-1) 

we might wish to apply a slight adjustment to DA so that Tmaziz) 
and dT e n(z)/dt remain zero. The amount of adjustment applied to 
DA is determined by the inputs and also the output control fuzzy 
set \i(DA). Which membership function of \i(DA) to apply is de- 
termined by the input membership function space and the opera- 
tor-inferred description of the control problem in the rule-base ta- 
ble. The idea is to maintain zero error and zero error derivative: 

dT m (z)/dt = T mm (z) = 



Figure 4 Fuzzifier rules and membership functions for 8-bit system 
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The number of inputs and the dimension of each determines 
the rule base matrix. For example, we have two input fuzzy sets, 
\u(T(Verr) and \i.(dT m /dt), with five membership functions each. 
This yields a 5x5 or 25 rule-base controller. The corresponding 
action to be performed by the evaluation of each input rule deter- 
mines the output controlling membership function \i(DA). For ex- 
ample, rule (3, 3) is: 

IF Tenor == M 

AND dT m /dt ==-M 
THEN DA ==Z 

and rule (3, 2) is: 

IF Terror == M 

AND dT en /dt == Z 
THEN DA == -M 

A literal evaluation of rule (3,2) would read, "If the feedback 
torque is less than the setpoint, and the feedback torque is ap- 
proaching the setpoint at medium rate, then apply zero bias to the 
PWM." The key to fuzzy logic control is that the degrees of mem- 
bership incorporate the amount of bias to apply and the degree of 
truth to each rule. (See Figure 4.) 
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When a Rule Fires 

A rule fires when a nonzero result is returned upon evaluation 
of the rale. The degree to which the rale is true is incorporated in 
the membership functions. If the input values lie within the mem- 
bership function trapezoid space, then the input is valid. A rule 
fires when both inputs to the rule are non-zero. A rule is evaluated 
using ternary operators similar in concept to Boolean operators. 
The operators logically follow the AND, OR, and NOT constructs. 



Listing 1 C declaration code for rule table and 
membership functions 











/* 

File: fuzzy. h 
Date: 4/3/93 

Author: Jack J. McCauley 
Header file for fuzzy. c 
********************«r*^^ 

/* membership function size */ 
♦define TORQUE_MEMBERS 5 
♦define DER.MEMBERS 5 

/* loop frequency */ 
♦define LOOPJZ 1 

/* integrator constant z-1*/ 
#define SKIP 1 

/* normalized value */ 
♦define NORMAL 255 

/* Current ma */ 
♦define MAX_TORQUE 1000 
//define MINJ10RQUE -1000 

/* derivative */ 

♦define MAXJERI L00P_HZ*MAX_T0RQUE 
♦define MIN_DERI LO0P_HZ*MIN_TORQUE 

/* pwn 1/10 % */ 
♦define MAX.PWM 255 
♦define MIN_PWM 

/* Max and Min */ 
♦define MIN_ERR0R 
♦define MAX_ERR0R 255 

/* size of all arrays */ 
♦define ARRAYJIZE 256 

/* represent a normalized -> 1000 = 0.0 -> 1.0 */ 
♦define FUZZY_RADIX NORMAL 

/* fuzzy max (ternary) operator */ 
♦define FUZ_MAX( x. y ) ((x>y) ? x : y) 

/* fuzzy min (ternary) operator */ 
♦define FUZ_MIN( x, y ) ((x<y) ? x : y) 

/* fuzzy AND operator */ 
♦define FUZ_AND( x, y ) FUZ_MIN( x. y ) 

/* fuzzy OR operator */ 
♦define FUZ_0R( x, y ) FUZ_MAX( x. y ) 

/* fuzzy compliment operator */ 
♦define FUZ_N0T( x ) ( Fl)ZZY_RADIX - x ) 
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Figure 5 Example of Fuzzify > Defuzzify when two rules fire 
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Rules and rule bases can be built using the operators exactly 
like those in standard Boolean logic, but because membership 
functions deal with degrees of truth we must have a mechanism 
for evaluating the operators: 

AND = MINIMUM(Input x, Input y) 
OR = MAXIMUM(Input x, Input y) 
NOT = 1.0 -Input x 

The AND operator returns the minimum of the result of a rule 
that has fired. The OR operator returns the maximum of the result 
of a rule that has fired. The NOT operator returns the complement 
of its input x, which is roughly the analog of ~x in C. 

In this application the AND operator is used exclusively to op- 
erate on the rule table inputs, and the normalized 0.0 -> 1.0 values 
are actually normalized eight bit values from to 255. 

(let dTerr(z)/dt = -1 1 and Terr(z) = 90) 

In evaluating the fired rules (3, 3) and (3, 2) shown above, we 
first determined if the inputs lie within the domain of \i( Terror) and 
MdTenm/dt) by examining membership functions for \i(T m0 t) and 
\i(dTtnot/dt). If the rule fires, we take the a cut for each of the 
input membership functions M and Z The a cut graphically slices 
the top of the output controlling membership function. The AND 
operator returns the lesser of the two a cuts for the inputs \i(dTet- 
im/dt, L) and ^(Terror, M) for use in the slicing operation. Because 
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Listing 1 continued 



I* create the membership function space */ 
/* first is the torque error fuzzy set */ 
struct s_torq_members { 

1nt neg_large[ARRAY_SIZE]; 

int neg_med[ARRAY_SIZE]; 

int zero[ARRAY_SIZE]; 

int posjned[ARRAY„SIZE]; 

int pos_large[ARRAY_SIZE]; 

float slope; 

float intercept; 
} torq_members; 

/* next is the rate of change fuzzy set torque error */ 
struct s_deri_members { 

int posJarge[ARRAY_SIZE]; 

int pos_med[ARRAY_SIZE]; 

int zero[ARRAY_SIZE]; 

int neg_med[ARRAY_SIZE]; 

int neg_large[ARRAY_SIZE]; 

float slope; 

float intercept; 
) derijnembers; 

/* last is the PWM fuzzy set ouput */ 
struct s_pwm_members { 

int neg_large[ARRAY_SIZE] ; 

int neg_med[ARRAY_SIZE]; 

int zero[ARRAY_SIZE]; 

int pos_med[ARRAY_SIZE]; 

int posJarge[ARRAY_SIZE]; 

float slope; 

float Intercept; 
} pwmjnembers ; 

/* define output rule table members */ 
^define L pwmjnembers. posjarge 

#define M pwmjnembers. posjned 

#define Z pwmjnembers. zero 

#define NM pwmjnembers. negjned 

#define NL pwmjnembers. neg_l a rge 

/* finally the fuzzy sets */ 
/* torque feedback error */ 
1nt *dTerr_dt[] = { 

derijnembers. posjarge , 

derijnembers . posjned 

derijnembers. zero 

derijnembers. negjned 

derijnembers. negjarge 

): 

/* torque (OZ-in) */ 
int *Terror[] = { 

torqjnembers. negjarge , 
torqjnembers .negjned 
torqjnembers. zero , 
torqjnembers. posjned , 
torqjnembers . pos J arge 
}; 

/* create the rule table and allocate space */ 
struct s_rule { 

1nt *tabl e[TORQUE_MEMBERS] ; 
} rule[DER_MEMBERS] = 



/* */ 
HZ, 
{ M, 
{ L, 
{ L, 
{ L. 



NM. 

Z, 

M. 

M, 

M, 



NM, 
NM, 

Z, 
M, 
M, 



NM, 
NM, 
NM, 

Z, 



NL }. 
NL }, 
NL }, 
NM ), 

Z }}; 
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COMM-DRV- 




COMM-DRV is a professional serial communication library for Windows and MS-DOS. In addition to the libraries, it 
comes with an extensive set of utilities, including a true Windows replacement driver, a true MS-DOS device driver, 
several TSRs, DLLs, debugging monitor, and much more. COMM-DRV may be used with any Language, any Tool, any 
Database Language/Environment, and any Application. Do not be fooled by false claims. COMM-DRV will be the only 
serial communication development tool you need. When you purchase COMM-DRV, you inherit a team of experienced 
professional software engineers to help in your design. And you get a 30 day money back guarantee. 



"Serial communication is at the core of what we do, and COMM-DRV has helped us rapidly develop new applications, and easily add 
multiple port features. We've been very impressed with the flexibility of COMM-DRV, and the technical support has been outstanding. " 

Lee Perryman, Deputy Director and head of technology development, Associated Press Broadcast Services, Washington, DC 



smart cards(Aniet Smartplus series, 
, PCXe). 



Transparent support for several 
Digiboard COMXi, PCXi, PCXm 
Support for all dumb mulitport boards on the market. 
Asynchronous callback to user functions on different serial communica- 
tion events(modem signals, buffer count, character reception and much 
more). 

Timed asynchronous callbacks to user functions. 
X, Y, & Zmodem on multiple ports concurrently. 
Complete source code to all libraries. 
Unlimited number of ports active concurrently. 
Real time serial port monitoring to screen and disk. 

Quickbasic, Visual Basic, C, Visual C++, Assembly, Microsoft Access 
examples. 

Hardware/Software Flow Control. 
Interrupt 14H/FOSSIL/EBIOS replacement. 

One API to leam (Same for Windows & MS-DOS). 



Desqview®, Procomm® Windows, PCBoard® BBS PcAnywhere® com- 
patible. 

Integrate with any database tool, language, or application without writing 
any serial communication code. 
ANSI/BIOS screen management utility. 

TSR to redirect serial data to keyboard buffer, transparent to user 
application( Great for barcode & POS apps). 
High level Hayes compatible modem support. 

True Windows comm device replacement. Use your favorite Windows 
communication applications on all multiport cards we support. 
True DOS device driver that allows serial ports to be opened as normal 
files under MS-DOS or Windows. 

Transmit data from user callback on any event(Important for multidrop 
applications). 

8250/16450/16550 Auto detection/Up to 1 15200 baud. 
Remap baud rates/Change baud rate divisor. 
Product customization. 



COMM-LOG- 

Group of cooperating programs and TSRs for developing 
serial applications quickly and efficiently. Programs and 
TSRs may be called directly from applications by shelling 
to them or by using a "C" API. Alternatively, applications 
may be built entirely with English like scripts. 

COMM-LOG Features: 

• TSR that log serial data to disk entirely in the background concurrently 
on any number of ports. Data may be extracted from the file while 
logging is in progress. 

• TSR to perform X/Y/Zmodem file transfers entirely in the background 
concurrently on any number of ports. 

• Full featured script engine that can function standalone or that may be 
called from a user application. Scripts may be run in the background. 

• Extensive set of examples. 

COMM-DRV $189.95 

COMM-LOG. $189.95 

MTASK $299.95 

COMM-DRV, MTASK Combo $399.95 

COMM-DRV, MTASK, COMM-LOG Combo ... $499.95 

4 Port Multiport Card(16450) $110.00 

4 Port Multiport Card(16550A) $170.00 

8 Port Multiport Card(16550A) $225.00 



MTASK- 

Multitasking kernel used in the development of multi- 
threaded applications and TSRs that run in the background. 
Its used commercially to create background TSRs for fax, 
communication, data acquisition, and many other applica- 
tions. All tasks may call DOS functions. 

MTASK Features: 

» Create and destroy tasks dynamically. 

> Put tasks to sleep for specific duration. 

> Send/receive messages between seperate threads in application and/or 
between TSRs running in the background. 

> Re-entrant libraries that include functions that make creating TSRs as 
easy as a C or Assembly function call. 

■ Extensive set of example that show the ease of writing TSR mat run 
entirely in the background. 



wcsc 

2470 S. Dairy Ashford Suite 188, 
Houston, TX, 77099 

1-800-966-4832 

713-498-4832 
Fax 713-568-3334 
BBS 713-568-6401 

Visa/Mastercard/ American Express/Optima/Discover 
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A Fuzzy-Logic Torque Servo 



Listing 1 continued 



The Fuzzy membership functions are stored in a look up table for all input 
and output fuzzy sets. Fuzzy variables with three digits of precision are 
normalized between 8 and 255 integer corresponding to an 8-bit radix converter 
and a fuzzy set 0.0 - 1.8 normalized value. Look up tables increase bandwidth 
and allow the servo to run with few floating point calculations. 

/********************************************************************** 

File: fuzzy. c 
Date: 4/3/93 

Author: Jack J. McCauley 
fuzzy torque controller for motor 
**********************************************************************/ 



include "stdio.h" 
include "stdlib.h" 
^include "conio.h" 
^include "proto.h" 

include "fuzz.h" /* the above file */ 



/********************************************************************** 
Routine: calces lope 
Date: 4/3/93 

Author: Jack J. McCauley 

calcs line slope of two points in a plane 

**************************************************** * J 

float calc_slope( float xl. float x2, float yl, float y2 ) { 
float slope; 



R eal-Time Multitasking with DOS 

for Microsoft C, Borland C, Borland/Turbo Pascal 



Develop Real-Time Multitasking Applications under MS-DOS with RTKernel! 

RTKernel is a professional, high-performance real-time multitasking kernel. It runs under MS-DOS or in ROM 
and supports Microsoft C, Borland C++, Borland/Turbo Pascal, and Stony Brook Pascal*. RTKernel is a 
library you can link to your application. It lets you run several C functions or Pascal procedures as | 
tasks. RTKernel offers the following advanced features: 



• pre-emptive, event/interrupt-driven scheduling 

• number of tasks only limited by available RAM 

• task-switch time of approx. 6 p sees (33-MHz 486) 

• performance is independent of the number of tasks 

• use up to 64 priorities to control your tasks 

• priorities changeable at run-time 

• time-slicing can be activated 

• programmable timer interrupt rate (0.1 to 55 ms) 

• high-resolution timer for time measurement (1 p sec) 

• activate or suspend tasks out of interrupt handlers 

• programmable interrupt priorities 

• supports math coprocessor and emulator 

• semaphores, mailboxes, and message-pas 

• keyboard, hard disk, and floppy disk idle t 
usable by other tasks 




for keyboard, COM ports, and 
included with source code 
36 COM ports (DigiBoard, Hostess boards) 
NS16550UARTchip 
r-network communication using Novell's IPX 
> runs under MS-DOS 3.0 to 6.0, DR-DOS, 
LANs, or without operating system 

• DOS calls from several tasks without re-entrance problems 

• supports resident multi-tasking applications (TSRs) 

• runs Windows or DOS Extenders as a task 

• supports CodeView and Turbo Debugger 

• ROMable 

• full source code available 

• no run-time royalties 

• free technical support by phone or fax 



RTKernel-C (MSC 6.0A7.0/8.0, BC++ 1 0/2.0/3.X) $495 (Source Code: add $445) 

RTKernel-Pascal (TP/BP 5.X/6.077.0, SBP 6.x) $445 (Source Code: add $375) 

For international orders, add $30 for shipping and handling. MasterCard, Visa, check, bank transfer, or COD accepted. 



On Time 

MARKETING; 



In North America, please contact: 

LEL Computer Systems 

20 Canterbury Court 

Setauket.NY 11 733 -USA 

Phone (516)473-81 19 -Fax (516)331-0706 



Professional Programming Tools 

Outside North America, please contact: 

On Time Marketing 

Karolinenstrasse 32 • 20357 Hamburg • GERMANY 
Phone +49 - 40 - 43 74 72 • Fax +49 - 40 - 43 51 96 
CompuServe 100140.633 



Jack J. McCauley 

of the overlapping domain of the member- 
ship functions, more than one rule will typi- 
cally fire. When this occurs, fuzzy logic pro- 
vides a mathematical method for dealing with 
multiple rule firings. The output of each rule 
is an output membership function that has 
been a cut and is then graphically ORed 
with the accumulated preceding output mem- 
bership functions. The resultant resembles a 
"shadow" of each fired rule with the accumu- 
lated output overlapping each preceding fired 
rule. Mathematically, the accumulation is the 
fuzzy OR operator (MAXIMUM) applied to 
the current rule that fires and the accumulated 
fired rules. (See Figure 5.) 

De-fuzzification 

The accumulated result of all firing 
rules occupies a two-dimensional space 
which is a fuzzy set with one membership 
function. The resultant must be converted 
to a real world crisp result which takes into 
account all applied rules. To do this, a spa- 
tial average is taken which computes the 
center of area (COA) of the function. COA 
is among several methods for computing the 
average. It is the method used in this appli- 
cation because it executes quickly. 

COA = (25*18 + 25*31 + 128*100 
+ 128*127 + 128*140) 
1(25 + 25 + 128 + 128 + 128) = 74 

So the DA value written to the PWM D/A 

is 74. 

C Language Implementation 

The membership functions use table 
look up to follow the example: 

\i(dT en0 r/dt) (in oz-in): 

-L WHEN dT en (z)/dt <= -35 

-M WHEN -50 <= dT m (z)/dt =< 

ZAf WHEN -10 >= dT en (z)/dt <= 7 

M WHEN <= dT en (z)/dt <= 50 

LWHENdT err (z)/dt>= 10 

All 25 rules are evaluated and the rules 
that fire result in a output according to the 
COA output de-fuzzifier function. The out- 
put array stores the result of the rule firing 
and the history of predicate rales. Conflicts 
are resolved using the fuzzy OR (MAXI- 
MUM) operator. The resultant outputs con- 
tribute to a weighted sum to yield the COA 
output. This strategy allows for the quick 
computation of a crisp -value using eighl- 
bit multiplies. 
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A Fuzzy-Logic Torque Servo 




docket into olb 

PASCAL or BASIC? 

Wish Your Software Was In 
C ? 




'Makes your CTSRs 
smaller than you 
could imagine." 

Mark Davidson, Computer Language 



The #1 TSR Library for C and ASM 



300+ functions in highly optimized assembler 
Auto-Disposal of initialization code and data 
I Hotkeys, schedulers, fast background COMs 
■ Safe DOS use from TSRs, Network Friendly 
■ Online hypertext help, Quick start templates 
■ Swap apps or graphics to EMS/XMS, spawn ... 



Pick of the Professionals 



"cream of the crop" 

Tom Swan, PC World 



"highly useful" 

Ft. Bradley Andrews, DDJ 



not only solves problems, it inspires new possibilities. 
It is destined for the programmer's Hall of Fame" 

Joe Campbell, Author C Programmer's Guide to Serial Communications 

"the size of any program you create with CodeRunneR 

Will aStOUnd yOU" Mark Davidson, Computer Language 

"excells in its TSR capabilities, coexistence with 
other DOS applications and support" 

Victor R. Volkman. The C Users Journal 

"professional development tool that'll let you create 

compact, fast TSRs" Gary Entsminger, Micro Cornucopia 

f"^OilYt"^ 0me 9 a Point > lnc - 

<£—. J 25 Birch Rd., Framingham, MA 01701 



Omega Point, mc, 508 877-1819 FAX: 508 877-0915 
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Then Don't Re-Invent the Wheel ! 

Automatically translate your code into readable 
and maintainable C with 
PASCAL and BASIC to C Translators 



Available for most popular variants 

eg. Turbo Pascal, VAX Pascall Basic, Microsoft Pascal/Basic 
For more information call now! 

Technosoft (US) Technosoft (Europe) 

PO Box 8210 Clarendon Court 

Rockford, jX 61 126-8210 Stockbridge, SO20 8HU. UK 

Phone:815-397-3214 Phone:+44-264-781626 
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READY TO 
DEBUG IN 
MINUTES. 

PAYS FOR 
ITSELF IN 
HOURS. 

AVAILABLE 
FOR ALL 

MAJOR UNIX 

PLATFORMS. 

WHAT MORE 

COULD YOU 

ASK? 

OKAY. TRY IT 
FOR 15 DAYS 
FREE. 

SENTINEL The Single Choice For 
Multi-Platform Memory Debugging. 

There's only one way to develop 
quality software for heterogeneous 
environments. Debug with SENTINEL. 

SENTINEL saves costly 
program repairs by detecting 
memory errors, leaks and 
run-time bugs before you 
ship your product. 

In fact, developers for HP, 
Sun, SGI, IBM, DEC, DG, and other pop- 
ular UNIX platforms find that SENTINEL 
can pay for itself the first 
time you use it. See for 
yourself. Call today for a 
FREE 15-day trial. You have 
nothing to lose. Valuable 
time to save. And better 
software to gain. 

What more could you ask? 

1-800-296-3000 

AIB SOFTWARE CORPORATION 

Formerly Virtual Technologoes, Inc. 
46030 Manekin Plaza, Suite 160, Dulles, VA 20166 
(703) 430-9247, E-mail: info@vti.com, FAX(703) 450-4560 
©Copyright 1993, AIB Software Corporation 
Registered trademarks are proprietary to their respective manufacturers. 




t SEN LINE 

m 




if ( xl == x2 ) 

slope = 
else if( yl == y2 ) 

slope = 0.0; 

else { 

slope = (yl - y2)/(xl - x2); 
if( slope > 100000000.0 ) 

slope = 100000000.0; 

} 

returnt slope ); 

I 

/it******************************************************************** 
Routine: calc_i intercept 
Date: 4/3/93 

Author: Jack J. McCauley 
calcs line intercept of two points in a plane 
**********************************************************************/ 

float calc_intercept( float xl, float x2, float yl. float y2 ) { 

float intercept; 

if ( xl == x2 ) 

intercept = 100000000.0; 

else { 

intercept = (y2*xl - yl*x2)/(xl - x2); 
if( intercept > 100000000.0 ) 

intercept = 100000000.0; 

} 

return ( intercept ); 

} 

/* end print_array */ 

Routine: down_load( ) 

Date: 4/3/93 

Author: Jack J. McCauley 
initialize fuzzy membership function tables from serial port DRIVER not shown 
*************************************************** 

void downjoadt int *membership_f unction, int len ) 

{ 

int k; 

char buff [32]; 

/*short, tight loop */ 
for( k=0; k< len; k-H- ) { 

/* get ascci string from driver */ 

gets( buff, 12 ); 

*membership_function++ = atoi ( buff ); 

} 



i'k^'kie'k'k'k'k'k'k'k'i'k'k 



I* end down_load() */ 
/************************■ 

Routine: fuzzy_init 

Date: 4/3/93 

Author: Jack J. McCauley 

initialize fuzzy membership function tables 
****************************** 

void fuzzy_init( void ) 
{ 

int k; 
long slope; 

long intercept; 

int val ; 

/* 

There are several ways to generate these tables: 

1) The easiest is to simply use ROM space and store them permanently in memory. FUZZ.H 
would need to be modified to reflect the static ROM delecerations for each fuzzy 
set and the values would be initialize directly attaching them to the data arrays. 
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For a micro-controller application, It 
was determined by experimentation that a 
loop repetition rate of at least 1 KHz 
would be required for satisfactory per- 
formance. Command set-points were en- 
tered through a serial port and an oscillo- 
scope measured the response of the loop. 
Figure 6 shows the measured step re- 
sponse, which is quite adequate. 

Conclusion 

Fuzzy logic control seems to hold 
promise as an alternative to standard PID 
control. Rigid modeling is not required be- 
cause the servo tuning is done via the 
fuzzy set membership functions and the 
rules. The rules incorporate Boolean state- 
ments and operator-inferred control rather 
than strict theoretical modeling. The mem- 
bership functions allow tuning of the con- 
trol system by altering the space that they 
occupy, and the placements of the output 
membership functions provide the control 
action to be performed by the rule. The rules 
use Boolean-like operators that infer a con- 
trol action depending upon the degree of 
truth of the rule firing. A rule fires if the 
fuzzified inputs return a non-zero degree of 
truth, referred to as the a cut for each input. 

Fuzzy logic is not as brittle as standard 
PID control because of the natural lan- 
guage approach to the control problem. 
Second-order effects such as temperature 
can be incorporated directly in the rule by 
logically appending another fuzzy set for 
temperature onto the rule. Suppose that we 
know that an increase in temperature 
causes the torque to change much more 
rapidly. By creating a rule base that incor- 
porates temperature, we compensate for 
the change, as in: 

IF Terror == M 

AND dT e „/dt == -M 
AND Temperature == L 
THEN DA = M 

In PID control second-order variables such 
as temperatures are not so easily incorpo- 
rated into the model. 

The fuzzy controller is also less prone 
to radix overflow and underflow prob- 
lems. In this application, the controller 
was implemented using eight-bit LUTs. 
All mathematical operations were cast to 
32-bit long, thus preventing overflow. Be- 
cause of the averaging nature of COA, it 
is inherently safe from overflow. □ 
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FINALLY ! 

Hi-Res Graphics and Formatted Text 
for Screen and Any Printer 



PRINT TOOLS LIBRARY C/C++ or BASIC (Inc. source code) $350 

AT LAST! Make your application device independent . . . without having to spend 
weeks or months in development time. One set of code supports text and graphics 
(BA/V and color) at full resolution for screen, laser, dot matrix, DeskJet, PaintJet, etc. 
Print Tools adds windows like functionality to your DOS programs. Great for graphs, 
pie charts, and forms. Set type justified, centered, flush right. Even a dot matrix 
achieves laser printer results. 

PCL TOOLKIT C/C++ or BASIC (Inc. source code) $215 

If your application supports PCL printers only, then the PCL ToolKit provides you with 
an easy and fast way to incorporate the PCL escape sequences into your program. 
Functions include: setting type centered, justified, flush right for both bitmapped and 
internal scalable fonts. Draw lines, circles, ellipses, arcs, pies, and 3-D bar shapes 
and fills. Add logos and pictures or PCX graphics. 

DESIGN-A-FORM III ™ with print preview $215 

Integrate complex forms into your program without having to learn a single line of PCL. 
Stand alone, menu driven program . . easy to use. Include logos/graphics, repeat 
check-off boxes across and down with a single instruction, copy and merge all or part 
of a form, access scalable fonts of the HP HI/4, import ASCII files and reduce the 
vertical spacing of the entire form as a single instruction. Plus get 6 fonts FREE. 
There is no royalty fee for distributing your forms or fonts. You are in total control. 

SCALABLE FONTS 

FONT MAKER LIBRARY C/C++ or BASIC $290 

This is not just a library for creating soft fonts, but a tool to create fonts from within your 
program. Download directly 'on the fly' or use the EXE program. Distribute fonts with 
your program — royalty free. Create any point size, bold and italic. Also, use with 
DESIGN-A-FORM and Print Tools. Includes one Font Pak, Roman or Helvetica. 
Additional Standard Font Pak $75. Custom Font Paks available. 

FONT CONSTRUCTION SET $490 

Our state of the art technology vectorizes a bitmapped font into a scalable font. 
Transform any of the hundreds of bitmapped fonts into your own scalable font. No 
royalty fees for distribution. If your applications require many typefaces and you want 
control over typeface creation, then the Font Construction Set is what you need. 



ProStall Ver. 3.0 $169 

ProStall Plus (with copy protection) $269 

First impressions count. So, if you distribute software to end users, give your product 
that professional image. Compress files and copy large files across multiple disks. 
Your company name appears during installation. Supports unlimited tree structure. 
You limit the number of installs if desired. Include up to two text files. Add PATH, 
FILE and BUFFER statements. Menu driven, easy to use — save time and money. 



(914) 354-8666 



USIN 

5C Medical Park Drive 



MS, I IMC. 

Pomona, NY 10970, 
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. cross compilers 

. function libraries 

. tutorials 

. games 

. disassemblers 

. communications 

. compilers 

. languages 

. and more 




CUG Library 
Directory 
Volume IV 

(Volumes 300-349) 



• volume cross 
reference by topic 



l=» H iWH =H 

• keyword index 

• reviews of key 
volumes 

• capsule summaries 
of ALL volumes 



The complete reference 
to volumes 300-349 of 
the CUG public domain 

and shareware 
C source code library 



Call 
TODAY! 



913-841-1631 
FAX 913-841-2624 



publications, inc. 
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2) Down load the fuzzy sets through the serial port as I did 1n the 
tuning of this servo. In which case I've included that code here (of 
course in the ROM version of the system you'll need D). 

3) Store the slope-intercept form of each membership function and 
calculate the line slopes and intercepts 

*/ 

/* 

Membership functions are downloaded through the serial port from a file in ASCII 
format one set member at a time. In this system I used a spreadsheet and 
graphical interface to actually draw the membership functions with a mouse. 
This aided in tuning the servo substantailly. In the ROH version of the system, 
I wrote a small programm to append the ROM statics memberships to fuzz.h. 
*/ 

downJoad( deri_members.neg_large, ARRAY_SIZE); 
down_load( torqjnembers.negjarge, ARRAY_SIZE); 
down_load( pwmjnembers.negjarge, ARRAY_SIZE); 
downjoadt deri_members.neg_med, ARRAY_SIZE); 
downjoadt torqjnembers.negjned, ARRAY_SIZE); 
down_load( derijnembers.zero, ARRAY_SIZE): 
downjoadt torqjnembers.zero, ARRAY_SIZE); 
downjoadt pwm_members.zero, ARRAY_SIZE); 
downjoadt derijnembers.posjned, ARRAY_SIZE); 
downjoadt orq_members.pos_med, ARRAY_SIZE); 
downjoadt pwmjnembers.posjned, ARRAY_SIZE); 
downjoadt deri jnembers.posjarge, ARRAY_SIZE); 
downjoadt torqjnembers.posjarge, ARRAY_SIZE); 
downjoadt pwmjnembers.posjarge, ARRAY_SIZE); 

/* slope intercept line calculation */ 

/* these line equations are used for scaling the 

crisp values from the above arrays */ 
derijnembers. slope = calc_slope(MIN_DERI, MAXJERI, 0, ARRAY_SIZE-1 ); 
derijnembers. intercept = calcJntercept(MIN_DERI, MAX_DERI, 0, ARRAY_SIZE-1 

torqjnembers.slope = calcjslopet MINJORQUE, MAXJORQUE, 0, ARRAY_SIZE-1 ); 
torqjnembers. intercept = calcJntercepttMINJORQUE, MAXJORQUE, 0, ARRAY_SIZE-1 ); 



)! 



f* 



pwm_members. slope = calc_slope(0, ARRAY_SIZE-1, MIN_PWM. MAXJWM); 
pwmjnembers. intercept = calcjntercept(0, ARRAY_SIZE-1, MIN.PWM, MAX_PWM); 



fort k=0; k<ARRAY_SIZE; k++ ) 

printff'Xd %4d %4d 354d %4d 
%4d\n",k,deri_members.pos J arge[k], derijnembers. pos_med[k], 
deri_members.zero[k],deri_members.neg_med[k],deri_memb 
ers.negjargefk]); 
*/ 
} 

/* end FUZZINIT */ 



Routine: defuzzify_COA 
Date: 4/3/93 

Author: Jack J. McCauley 
defuzzify using COA 
********************************************** 

float defuzzify_COA( int *output ) { 
static long k; 

static long numerator, denominator, val; 

numerator = 0; 
denominator = 0; 

for ( k=0; k<ARRAY_SIZE; k+=SKIP ) C 
val = (long)*output; 
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Version 2.D 

The World's 
Most Complete 
G Communications 
Toolkit. 



Programmers call Magna«Comm C "the complete C communi- 
cations toolkit" because it supports nearly every product and 
program with hundreds of powerful communications features. 
Magna'Comm C is the fast and easy way to add complete 
communications to all your applications. 

Complete... FAX support - meets atl CAS standards. 
Complete... Serial communications. 

Complete... Support for DOS and MS-Windows in a single package 
(Magna'Comm C for Windows). Use the same function calls in 
both environments. 

Complete... With a terminal program application (similar to MS-Windows 
terminal) to show how to use Magna'Comm C under Windows 
or to add to or modify in your applications. 

Complete... Support for nearly every program or product including MSC 
5.I+/Quick C, Borland Turbo 3.0+, Watcom C and more. 

Complete... Support for Z-modem and CompuServe QuickB File Transfer 
Protocol Suite. 

Complete... Network modem support. 

Complete... Diagnostics to determine if devices can share interrupts. 

Plus, complete modem support, chip support, serial port 
support, flow control, terminal emulations, speeds up to 
I 1 5,000 bps, and an extensive 600 page manual with 1 25 pages 
of background and 35 example programs. 

ONLY $229 (US) MAGNA'COMM C FOR DOS (PLUS SHIPPING) 
Magna'Comm C for Extended DOS -$299 (US) 
Magna'Comm C for MS-Windows - $299 (US) 
Magna'Comm C Professional Combo - $499 (US) 



COMPLETE. 



SOURCE CODE INCLUDED. 
PLUS FULL-TIME TECH 
SUPPORT. 



For ordering and information call toll free 

i-800-755-7344 S d 

Major credit cards accepted 




DISTRIBUTED BY: SOFDESIGN INTERNATIONAL, INC. • 1303 COLUMBIA DR.. SUITE 209 RICHARDSON. TX 75081 USA • VOICE: (214)644-0098 • FAX: (214)644-4286 
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C CODE FOR THE PC 

source code, of course 

Graphic 7.0 (high-resolution, scientific plots in color & hardcopy, contour plots, device independence) $370 

X/DOS and Xt/DOS (Xlib with X client and Xt toolkit for DOS; port X code to DOS; Xt/DOS requires X/DOS and 32-bit compiler) . . each $300 

ZIP Image Processor & Victor Image Library Version 2.2 (brightness, contrast, merge images, TIFF/GIF/PCX/bin, HP ScanJet support) . . $290 

The Snooper (Ethernet protocol analyzer for Novell NetWare and LAN Manager Networks; capture packets; real-time display) $275 

Embedded BIOS (full-featured, real-time input/output system; PC, XT, AT, for example, 80186 with 8259 interrupt controller) $260 

C/C+ + Libraries by Code Farms (persistent C structures, ER models, dynamic arrays, database functions, Jolt Award winner; specify C or C+ +)$250 

TurbolgX (Release 3.0; HP, PS, dot drivers; CM fonts; LalpX; MetaFont) $250 

Rogue Wave tools.h-f- (- or math.h++ Class Library (extensive docs) each $240 

Crusher! (platform-independent data compression for network transfer; beats PK & LH on binary, directory trees; portable C) $215 

COMM-DRV (complete interrupt -driven serial communication libraries & device drivers; full source) $155 

TE Editor Developer's Kit Ver. 3.0 (full screen editor, undo command, multiple windows; with Word Processing $230) $155 

Minix Operating System (Version 1.5; Unix-like operating system, includes manual; specify 5.25" or 3.5" diskettes) $150 

XASM (cross assemblers & utility programs; 65xx, 68xx, 80xx; Intel or Motorola hex format; macro preprocessor) $150 

Delorie GCC for MS-DOS (Version 2.Z2; includes C++, assembler, DOS extender, 387 emulation; complete source code and makefiles) . . $150 

Moby Crypto (PGP, DES, Secure Hash, UFC, MDs, Crack 4.1, Lucifer, IDEA, VCR+, large integer packs, tutorials, more; not for export) . . $150 

Lisp for DOS (Kyoto Common Lisp and CLISP; KCL includes Lisp-to-C translator for building mixed Lisp/C programs) $140 

Ibrow (Version 4.1; programmer's windows-based editor, large files, help, undo/redo, drag-n-drop, function & type tags) $135 

Booter Toolkit (floppy disk bootstrap routines, DOS file system, light-weight multitasking, windows, fast memory management) $120 

SCM (portable Scheme in C, IEEE standard, includes JACAL symbolic math package; SCM-4D0/SLIB-lD5flACAL-lA3) $100 

PC/IP (CMU/MIT TCP/IP for PCs; Crynwr drivers, NFS server, Bdale mailer, PCRoute/PCBridge, NDIS/ODI drivers, Beholder, more) . . . $100 

DA (disassembler for Microsoft's New Executable (NE) binary files including Windows .exe, .drv, .dll, and .fit) $95 

Script Interpreter (a command script interpreter for DOS-based systems; C-like script language; lots of features) $90 

CELP 3.2c (Federal Standard 1016 Code Excited Linear Predictive voice sampling and encoding; voice over 4.8kbps; Unix code) $80 

CPPCOMM (C++ serial communications class library for DOS, Windows, OS/2, and NT; includes XATZmodem) $75 

ET Neural Net (back error propagation and Kohonen; specify DOS text, DOS VGS, or Windows) $75 

FlexList (doubly-linked lists of arbitrary data with multiple access methods; specify C or C+ +) $65 

Kier DateLib (all kinds of date manipulation; translation, validation, formatting, & arithmetic) $60 

Coder's Prolog (Version 3.0; inference engine for use with C programs) $60 

PCCTS Version 1.10 (Purdue Compiler Construction Tool Set; like YACC and LEX together with lots of additional features) $60 

Container Lite V 1.82 (C+ + & FLC wrapper emulators; portable, persistent containers of arbitrary data including pointers) $50 

BigFloat (arbitrary precision floating point arithmetic and functions; includes BCD conversion) $50 

EZCalc (ASCII algebraic expression evaluator, unlimited parenthesis nesting, symbols, 32 built-in functions, easily extended) $50 

Backup & Restore Utility by Blake McBride (multiple volumes, file compression & encryption) $50 

CLIPS Version 6.0 (rule-based expert system generator; Windows compatible; hardcopy manuals additional) $50 

SuperGrep (exceptionally fast, revolutionary text searching algorithm; also searches sub-directories) $50 

OBJASM (convert .obj files to .asm files; output is MASM compatible) $50 

Editor Pack (20 public domain editors; micromacs 3.12, Stevie, Elvis, Moke, mg2a, DTE, Jove, Origami, CE & GRIEF) $50 

Exceptions for C (Ada-like exception handling for C programs; exceptions for any block; exceptions can be reraised) $45 

DES Encryption & Decryption (2500 bits/second on 4.77 MHz PC for on-the-fly encryption at 2400 baud; not for export) $40 

Database Pack (9 databases - simple to complex: isam, bplus, AVL, SDB, ID, gdbm, Requiem, Ingres89, Postgres) $35 

COP (poor man's C++; C macro package which implements C++ in C) $35 

OCT (Object C Translator; essentially Brad Cox's Objective-C Version 4) $35 

RXC & EGREP Version 2.0 (Regular Expression Compiler and Pattern Matching; finite state machine from regular expression) $35 

Bison & BYACC (YACC workalifce parser generators; documentation; includes C and C++ grammars) $35 

Spell Pack (6 spelling programs, a hyphenator, 2 utility packs and a 60K word list: Ispell, Microsp, Sp, Cspella, Spell. Dawg, Soundex) .... $30 

REGX Plus (Version 3.0, search and replace string manipulation routines based on compiled regular expressions) $30 

GNU Awk & Diff for PC (both programs in one package) $30 

Big Number Pack (7 arbitrary precision arithmetic packages in C, one in Fortran but free Fortran-to-C converter is included) $30 

Crunch Pack (30 file compression & expansion programs; now includes portable ZIP) $30 

OORT (C+ + ray tracing code from the book by Nicholas Wilt) $30 

OEmacs (full GNU Emacs for DOS and Windows DOS box; C+ + support, etags++, lotsof. el files) $25 

CTask Version 2.22d (robust MS-DOS multitasking kernel; C functions run as light-weight processes; mailboxes, interrupts, pipes, etc.) . . . $25 

PERL for MS-DOS (Version 4.019; C, sed, awk, and shell all rolled into one language; includes hardcopy docs) $25 

FLEX Version 2.4.3 (fast lexical analyzer generator; new, improved LEX) $25 

GNU RCS (FSFs version of the Revision Control System; like Unix's SCCS only better; keeps track of software development) $20 

Data 

Moby Thesaurus II (6,000 root words, 2.5M synonyms, "common sense", concept related searches) $500 

Moby Pronunciator II (175,000 words & phrases encoded with full IPA pronunciation & emphasis points) $265 

Moby Part-of-Speech II (230,000 words and phrases described by prioritized part(s)-of -speech) $170 

Moby Hyphenator II (185,000 words fully hyphenated/syllabified) $105 

Moby Words II (610,000 words & phrases with Scrabble(tm) word list, place names, baby names, acronyms, core list for spell checkers) . . . $100 

U. S. Cities (names & longitude/latitude of 32,000 U.S. cities and 6,000 state boundary points) $35 

The World Digitized (100,000 longitude/latitude of world country boundaries) $30 

CD-ROMs 

BSD/386 (POSIX-compatible O/S; complete development package, full networking, kernel debugger, X11R5, DOS box; complete source code) $900 

AI CD-ROM (expert systems, neural networks, genetic algorithms, fuzzy logic, linguislics/nalurafTanguage) $105 

FontMaster II CD Library (soft fonts for HP and HP compatible laser printers, 36 different type faces; 5,200 bit mapped fonts; 300MB) . . . $70 

Prime Time for Unix (Volume 3, No. 1, January, 1994; over 6GB of Unix C code) $60 

Walnut Creek Libris Britannia (over 600MB of the best of British boards; not all source included) $55 

Mailer's Lookup (9-digit ZIP codes by street address or company name, distances between ZIP codes, phone locations; on-line tool) .... $50 

Linux/GNU/X by Yggdrasil Computing (1st production release; run from the CD; TCP/IP & NFS; drivers; MPEG; SCSI support; lots more) . $45 

Walnut Creek C User's Group (Volumes 100 to 364) $40 

Walnut Creek Linux VO.99.13 (100's of tools; drivers for all sound, CDs, video; X- Windows; software engineering tools; easy install $40 

InfoMagic Unix (three public domain Unix systems: 386BSD (version 0.1), Linux (version 0.99.10), and NetBSD) $40 

InfoMagic Source Code (Berkeley Net/2, MACH, GNU, Interviews, X, Andrew, XFree, Demacs & Winemacs, djgpp, Modula-3, etc.) ... $40 

Knowledge Media Multimedia (625MB & 13,000 files; 1,232 sounds, 179 books, 100 movies, 114 stacks, 606 programs, 214 mods) $35 

Walnut Creek Space & Astronomy (1000 images, 5000 text files, sci. space archive, astromony software; CD viewer included) $35 

Project Gutenberg (literature, historical documents, reference books, census data, religious documents, math constants, etc.) $35 

Knowledge Media Languages & Operating Systems (640MB of compilers, libraries, and operating systems; source code & executables) ... $35 

Walnut Creek X11R5 and GNU (X11R5 with contributed and comp.sourcesjt, over 120 GNU programs, complete C source) $35 

Walnut Creek Usenet and Simtel Unix-C (600MB) $35 

Walnut Creek Giga Games (arcade, simulations, card games, education, trivai, cheat sheets; some source) $35 

Austin Code Works Internet warrior #1 (PC Internet tools: Gopher, Wais, Eudora, ph, Nupqp, Trumpet, TCP/IP, FAQs, drivers, docs) ... $35 

NetGems of 1991 (comasources.', alt.sources. • of 1991, plus XI 1R5 and GNUware and RFCs; Unix file system not ISO-9660) $20 

walnut Creek Simtel 20 MSDOS Archive (C source code but lots of other stuff too) $20 

Sprite Network Operating System (source code & documentation of Ousterhout's Sprite O/S; Sun and DECStation boot images) $20 

The Austin Code Works Voice: (512) 258-0785 

11100 Leafwood Lane much more ... ask for catalog FAX: (512) 258-1342 

Austin, Texas 78750-3587 USA E-mail: info@acw.com 

Free surface shipping for cash in advance For delivery in Texas add 7% MasterCard/VISA 
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output+=SKIP; 

/* look for non-zero values and include in our COA calc */ 
if( val ) { 

denominator += val ; 

/* ROM based later */ 

numerator += val *(long)k; 

} 

} 

/* divide if non-zero x/D */ 
1f( denominator ) { 

/* return crisp value */ 

/* Could be converted from float if desired */ 

numerator = (long)((float)(numerator/denominator) * pwm_members.slope + 
pwmjnembers . i ntercept ) ; 

return( numerator ); 

) else 

return( ); 



} 

/* end COA calc */ 



/*** 

Routine: fuzzify 
Date: 4/3/93 

Author: Jack J. McCauley 
fuzzifier for our servo 

int fuzzifyt int derr_dt, int err, 

int *p_Terror, int *p_dTerror, 
int *p_out, int *resultant ) { 

static int k, val, alpha_cut, temp, *moe; 



COA method 



*/ 



Get the alpha cut for error and derivative. Use the AND (min) operator and cut the 
output , a non-zero fuzzy MIN indicates a rule has fired . write the cut to the result 
array by "shadowing" the exisiting using the MAX operator 
*/ 

/* normalize the output derivative */ 
moe = resultant; 

/* Find out if the rule fired. If the rule fired then get the alpha cut */ 
if( (alpha_cut = FUZ_AND( p_dTerror[derr_dt], p_Terror[err] )) != ) { 

for ( k=0; k<ARRAY_SIZE; k+=SKIP ) { 

/* 

An interesting effect will be noticed if the skip is set greater than 
1. In this system setting skip to lets say 2 or three will yield 

in most circumstance yield the same defuzzified crisp output if the 
slope of the membership functions are not too steep. 

The other benifit is that the execution speed 1s Increased greatly 

*/ 

/* create shadow */ 
val = *p_out; 

/* don't get bit by shortcuts *./ 

val = FUZ_MIN( alpha_cut, val ); 

temp = *resultant; 

♦resultant = FUZ_MAX( temp, val ); 

resultant+=SKIP; 

p_out+=SKIP; 

} 



} else 



/* rule fired */ 
return( 1 ); 

/* rule didn't fire */ 
return( ); 
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The original user interface tool 
kit, Vitamin C's library of C functions 
makes your C/C++ programs faster to 
code and easier to use. 

Simple C function calls get you 
up and running quickly with solid, 
reliable solutions including: 



♦ Windows 

♦ Menus 

♦ Entry fields 

♦ Validation 

♦ Push buttons 

♦ Radio buttons 

♦ Check boxes 



♦ List boxes 

♦ Scroll bars 

♦ Text Editors 

♦ Help system 

♦ List manager 

♦ Full mouse 
support 



Vitamin C's event driven, 
message based design gives you 
maximum flexibility to express your 
style and vision-not ours. 

Of course, library source is 
included and your programs are 
royalty free! 

Vitamin C 4.0 $395.00 

The next generation in C source 
code formatting, CodeScan makes 
any C source file easier to read, 
maintain, and debug. 

With its unique, interactive 
control panel, you'll quickly and 
easily tell CodeScan how to format 
your code. No cryptic command 
lines or config files. 

CodeScan 2.0 $79.00 

Order and information hotline 

li'J'JyJ'Jj^yy 

Creativs Programming y /^Ny 

P.O. Box 1 12097 

Carrollton. Texas 750 1 1-2097 USA 
(214)245-9139 Fax:(214)245-9717 
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Flash Graphic* 



1 Real tV protected mode 16-bit support 

* 32-bit protected mode support 

* Wide range of graphic adapter support 
1 Virtual screens 

' Multiple simultaneous graphics -adapters 

* B(Jl interface available 



$250, No Royalties 





k-32VM 32-hit DOS Kxtendci 

• I p to 3.5 gigabytes of virtual memory 

• I lira compact, self-contained cxecutables 

• Fully compatible with Zor tech's DOSX 

• Support for Watcom < >J.S/.>S(> 

• Support for Borland C+ + for OS -2 

$250, No Uo\ allies 
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\*sW5> = bug[nj: 





Source level debugger for C + 
ibler programs, 
to use expansion of classes, 
res, pointers, arrays, etc. 
Powerful run-time memory protection 
detects pointer bugs 
Full nested call traceback display with 
automatics and parameters 
Unlimited number of break and trace poini 
History buffer for recording up to 
32,000 source lines and variables 
Program execution time recording for 
timing analyses 
Dual monitor debugging 



I 



FlashTek is proud to offer former Zortech 
products, hy the original authors, now w ith 
support for other compilers. New features, 
fantastic support, no royalties, and great 
prices. _ 

OWDIiKS 800-397-7310 11 li^JJ. 



FiashTek, Inc. 
121 SwlcI Ave. 
Mostow, Idaho 83843 
Info: 2Q8-882-6893 
Kinsiil: llasli@prolo.coni 
FAX: 208-882-7275 



FlashTek, Lid. 
3 Partnership I louse 
W illiam Brook Park 
Grantham, I-ines 
England NG31 ')I1Z 
Voice+44-476-74108 
FAX+44-476-61382 



Listing 1 continued 



} 

/* end FUZZIFICATION calc */ 



Routine: servo_torque 
Date: 4/3/93 

Author: Jack J. McCauley 

fuzzy servos to torque set point 



/***** 



/* 

Routine would run as an ISR attched to a timer interrupt passed values are read 

from and A/D converter and command torque (serial port etc..) 

*/ 

long servo„torque( int error, int derr_dt ) 
{ 

/* statics for speed */ 
static int row, column; 

/* pointers to tables */ 

static int *p_out, *p_dTerr_dt, *p_Terror; 

/* COA container class */ 
static int resultant[ARRAY_SIZE]; 

/* zero fill the array */ 
for( row = 0; row<ARRAY_SIZE; row++ ) 
resultant[row] = 0; 

/* normalizing the error derivative will allow the error to ff 

/* normalize error derivative to look up table RADIX*/ 

error = (longH(float)error * torqjnembers.slope + torq_members. intercept); 

/* normalize error derivative*/ 

derr_dt = (long)((float)derr_dt*deri_members. slope + deri_members. intercept); 

/* MAX and MIN error */ 
if( error > MAX_ERR0R ) 

error = MAXJRROR; 
else 1f( error < MIN_ERR0R ) 

error = MIN_ERR0R; 

/* MAX and MIN derivative */ 
if( derr_dt > MAXJERI ) 

derr_dt = MAXJERI; 
else if( derr_dt < MINJERI ) 

derr_dt = MIN_DERI; 

/* traverse the rule table and evaluate the rules */ 
fort row = 0; row < DER.MEMBERS; row++ ) { 

/* get pointers to tables from data structures */ 
p_dTerr_dt = dTerr_dt[row]; 

for( column = 0; column < TORQUE_MEMBERS; column++ ) { 

/* get pointers to tables from data structures */ 

/* get the output membership function for that rule evaluation */ 

p_out = rule[ row]. table [column]; 

pjerror = Terror[column]; 

/* fuzzify the rule */ 

fuzzifyt derrjt, error, pjerror, p_dTerr_dt, p_out, resultant ); 



/* defuzzify using COA */ 

returnt defuzzify_COA( resultant ) ); 

/* return the fired rules */ 



/* END */ 
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Run-Time Type Checking in C++ 



Run-Time Typing 

I have taught myself C++ and am comfortable with most of its 
concepts. There is one aspect that I am unsure about. Bjarne 
Stroustrup, in his book The C++ Programming Language states: 
"using run-time type inquiries ... destroys all modularity in a pro- 
gram and negates the aims of object-oriented programming." I at- 
tempt to adhere to this suggestion, but there is a situation in which 
I don't know how to apply the rule: read- 
ing and writing objects to data files. As 
an example, let's suppose we are writing 
a simple checkbook balancing program. 
The base object is an Entry, which corre- 
sponds to something you would enter in 
your checkbook. Derived from base class 
Entry are three classes which can be in- 
stantiated: Check (a written bank draft), 
Deposit (a bank window deposit), and 
yithdrawal (a window withdrawal). 
Keeping track of the type of objects in 
memory is easy, since when one of the 
three derived classes is created, it is done 
through a constructor which builds in 
type information. There are many ways 
to write the checkbook entries to a data 
file, so let's assume we just write a char- 
acter-based representation to the file. The 
question is how can we write the data so 
that we can read the information back 
into memory? The only way I can think 
of is to include type information, such as 
an integer coded for each class type. This 
method violates Mr. Stroustrup's rule, 
though. Any thoughts you have on this 
matter would be greatly appreciated. 

Paul Waldo 
Forest, VA 

A One reason Bjorne was against run-time checking was be- 
cause it enables programmers to avoid derivation. For ex- 
ample, suppose you have a type_of function that can identify the 
Entry type of a pointer. To post an entry, you might code some- 




thing that looks like Listing 1. If you need to add an additional 
type of Entry, then you have to add another case to the switch 
statement. 

However, there's a cleaner way to handle this problem. Sup- 
pose you give Entry a pure virtual post function. Each class de- 
rived from Entry now supplies its own post function. The 
post_entry function could look like Listing 2. When adding a new 
derived class, you do not need to change the post_entry function. 

You just provide a post function for the 
new class. 

As you have suggested, virtual func- 
tions only work while objects are in 
memory. Each object of a class with vir- 
tual functions contains a pointer to a ta- 
ble of function pointers (the vtable, as it 
is sometimes referred to). All objects of 
a particular class contain a pointer to the 
same table. When the program calls a 
virtual member function it uses the 
pointer to the corresponding function in 
the vtable. In a sense, this vtable pointer 
uniquely identifies the class type of an 
object. In fact, some compilers have 
non-standard extensions that can use this 
pointer to provide a form of run-time 
type identification. Other vendors pro- 
vide alternative methods for run-time 
identification. Microsoft has a CRuntime- 
Cldss object associated with each class 
that is used with the IsKindOf function. 
With this function, you can determine if 
an object belongs to a particular class or 
if it is derived from a class. (The class 
must be derived from the Microsoft COb- 
ject class to work with IsKindOf.) To use the IsKindOf function, 
you include a DECLARE_DYNAHIC macro in the class definition and 
an IHPLEHENTJYNAHIC macro in the class implementation. CRun- 
timeClass is the data type used to store class information. You 
can obtain a pointer to an object of this type with: 

CRuntimeClass * pel ass = RUNTIME_CLASS(Your_class); 



Kenneth Pugh, a principal in Pugh-Killeen Associates, teaches C and C++ language courses for corporations. He is the author of All On C, C 
for COBOL Programmers, and UNIX for MS-DOS Users, and was a member of the ANSI C committee. He also does custom C/C++ program- 
ming and provides SystemArchitectonics™ services. His address is 4201 University Dr., Suite 102, Durham, NC 27707. You may fax questions 
for Ken to (919) 489-5239. Ken also receives email at kpugh@allen.com (Internet) and on Compuserve 70125,1142. 
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Typically you do not use the information in CRuntimeCldSS di- 
rectly, but instead pass it to IskindOf. For example, as shown in 
the following code fragment, you might want to cast a base class 
pointer to a pointer to a real object. To be logically correct, you 
need to be sure the object pointed to belongs to a particular class. 

CObject * pyour_object = new Your_class; 

if ( pyour_object->IsKindOf( RUNTIME_CLASS(Your_class) ) ) 
{ 

// Cast it 



Listing 1 One way to do run-time type checking 




void Account: :entry_post(Entry * pentry) 
{ 

switch (type_of (pentry)) 
{ 

case Deposit_entry: 

balance += pentry->amount; 

break; 
case Check_entry: 

balance -= pentry->amount; 

break; 
case Withdrawal_entry: 

balance -= pentry->amount; 

break; 

} 

/* End of File */ 



Utile Big Ion 



' Peer to Peer LAN, to 250 nodes 
, $75 total software cost! 

No matter how many nodes ! 

Use Ethernet, Arcnet or 

serial/parallel/modem to connect. 



► Mixed mode routing 

Any combination of above connection is possible 
on any given node. 



. Use with windows 

Seen as 100% compatible 
Microsoft Network 
by Windows 3.x. 




Information Modes 

P.O. Drawer F 
Denton TX 76202 
817-387-3339 Techline 
817-382-7407 Fax 

1-800-628-7992 Orders 



The $25 Network 



Try the 1st truly low cost LAN 

« Connect 2 or 3 PCs. XTs. ATs. PS/2s 

• Uses senal ports and fj wire cable 
» Huns at 115K baud, up to 90 feet 

• Transfer 8300 bytes per second (ATs) 

• Runs in background, totally: transparent 

• Share any; device, any file, any time 

• Needs only 1SK of ram 

• Just $25 per network. NOT :PEfl NOBEI 

• Replace all file transfer software 

• Version 2.3P now has Tiny MAIL 

• OVEft 20.000 SOLD WORLDWIDE ; ; 

Skeptical? We make believers! 
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Your_class * p_this_object = 
(Your_class *) pyour_object; 

} 

You can use this type information to create objects of a given 
class. The CRuntimeCldSS class provides a member function 
CreateObject for dynamically creating objects. The use of 
CreateObject is demonstrated as follows: 

CRuntimeClass * p_jour_class = RUNTIME_CLASS(Your_class); 
// Create it 

CObject * pyour_object = 

p _your_cl ass->CreateObject( ) ; 
// Cast it to the class 
Your_class * p_this_object = 

(Your_class *) pyour_object; 

In your question, you have run across one area of program- 
ming that requires some form of type identification: permanent or 
persistent storage. You cannot use the address of a vtable as the 
identification means for an object. When the contents of an object 
are read back into memory, the chances are that the vtable will be 
in a different memory location. You will need to store some form 
of type identification with the object. This identification could 
either be an integer value or the string name of the class. If your 
program stores objects in a known sequence and retrieves them by 




Listing 2 Virtual functions simplify run-time type 

seeking 



ch 



void Account:: entry_post( Entry * pentry) 
{ 

balance = pentry->post(balance); 

} 

/* End of File */ 




Code that one compiler didn't like 



I* GRM-P45.C -- Graham, Learning C++, p. 45 */ 
// File rabbi ts.ccp 

// Program for inverse Fibonacci rabbit problem 

^include <iostream.h> 

mainO 
{ 

// Get input from user 



// number of pairs this month 
// number of fertile pairs 
// number of pairs needed 



long current; 
long fertile; 
long needed; 

}" 

Error messages: 



Compiling C:\GRM-P45.C: 

Error E:\TC\INCLUDE\IOSTREAM.H 38: Declaration syntax error 

Error E:\TC\INCLUDE\IOSTREAM.H 39: Declaration syntax error 

Error E:\TC\INCLUDE\IOSTREAM.H 42: Declaration syntax error 

// End of File 
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the same known sequence, then you do not need any type identifi- 
cation stored with the object. For example, if you always store 
Checks starting at the first position in the file, followed by Depos- 
its and then iiithdrawals, you can determine the type of an object 
by its position in the file. In your example, you cannot assume this 
kind of ordering exists, so you must store a class identifier. There 
are lots of ways to store this identifier, depending on how your 
classes are organized. Let's assume you have some unique identi- 
fier for each account entry type, such as: 

enum Entry_type {Entry_check, Entryjeposit, 
Entry_withdrawal}; 



if ( this->IsKindOf(pcheck) ) 

// Store Entry_check 
else if (this->IsKindOf (pdeposit) ) 

// Store Entry_deposit 
else if (this->IsKindOf(pwithdrawal) ) 

// Store Entry_withdrawal) 

// Store remaining contents in an account 

} 



One of these values would be stored 
away with each object. For example, if 
your compiler provides run-time type iden- 
tification with type_of, you might code: 

Entry ::save() 

{ 

if ( this->type_of() == Check ) 

// Store Entry_check 
else if (this->type_of() == 
Deposit ) 
// Store Entry_deposit 
else if (this->type_of() == 
Withdrawal ) 
// Store Entry_withdrawal ) 

// Store remaining contents 

// in an account 

} 

Before I get too much mail regarding 
this "hidden switch statement," let me ex- 
plain that this function is complementary 
to the retrieval function, which I will show 
shortly. You could use a virtual function 
for save in each of the derived classes. The 
function would store the appropriate En- 
try_type value, call a save function in the 
Entry class to store the data members in 
that class, and then save its own data 
members. If you were using the Microsoft 
compiler, this type checking code might 
look like the following fragment. How- 
ever, Microsoft provides other functions 
that make this code unnecessary, as we 
shall see shortly. 

Entry: :save() 
{ 

CRuntineClass * pcheck_class 
= RUNTIME_CLASS(Check); 

CRuntimeClass * pdeposit_class 
= RUNTIME_CLASS(Deposit); 

CRuntimeClass * pwithdrawal_class 
= RUNTIME_CUSS(Withdrawal); 
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The basic dilemma comes in retrieving the objects. You cannot 
use a retrieve function for each derived class, as you do not 
know the type of entry for the next object stored in the file. Thus 
you can only retrieve an entry as a base class object. For exam- 
ple, the caller might use something that looks like: 

Entry *pentry; 
Account account; 

account. retrieve_next(&pentry); 

The retrieve_next function could look like the following: 

int Account: :retrieve_next( Entry **pentry_in) 
{ 

// Get rid of old pointer 
Entry *pentry = *pentry_in; 
if (*pentry != NULL) 

delete pentry; 
// Read the record off disk 
// Then check the type of the record ready 
if (type == Entry_check) 

*pentry = new Check; 
else if (type == Entry_deposit) 

*pentry = new Deposit; 
else if (type == Entry_withdrawal) 

*pentry = new Withdrawal; 
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// Move associated data into the type 

// Then return the pointer 
*pentry_in = pentry; 
} 

The caller passes this function a pointer to pointer to the Entry 
class. The function deletes the Entry that was pointed to by pen- 
tryjn. The Entry class should provide a virtual destructor, so that 
any additional data members in the derived classes are deallo- 
cated. Based on the Entry_type value stored in the file, the func- 
tion allocates the appropriate pointer. The function moves the nec- 
essary data from the file into the new object and returns the value 
of the pointer. If necessary, each derived class can include a func- 
tion that reads any additional data members from the file. 

The Microsoft archive retrieval function (CArchive: :opera- 
tor») does not require this if-else structure. The storage function 
(CArchive: :operator«) stores a run-time class identifier (the 
name of the class) in the file. When the retrieval function reads 
the file, it dynamically creates an object of the stored class and 
loads the information from the file into that object. Microsoft's 
multi-pronged approach to run-time typing eliminates worries 
about the details of persistent object storage and retrieval. All you 
have to do is to include the necessary macros in your object 
header file and your object implementation file. 

C++ Problems 

I am an agricultural economist at the U.S. Department of Agri- 
culture and am trying to learn C and C++. I have bought over ten 
books on C, and am reading them and keying in the exercises to 
practice the concepts. One of the books I have bought is Learning 
C++, by Neil Graham. I began keying in one of the exercises (in 
C++) and the program gave me a bunch of iostream declaration 
errors when I attempted to compile the source code using Borland 
Turbo C++, 1991 (Listing 3). I saw your column in The C Users 
Journal and thought that you might be willing to suggest what is 
wrong, and how I might fix it. Also, do you have any recommen- 
dations for textbooks and/or diskette tutorials that may be useful 
in learning C and C++? 

Kenneth W. Erickson 
Washington, D.C. 

A Reading several books and trying their examples is an ex- 
cellent way to learn a new language. You can get a good 
feel for alternative ways of approaching problems. However, when 
you use only books for learning, you often run into problems for 
which a book has no answer. Many times I've been in the same 
quandary when using vendor-supplied manuals. In some cases the 
solution to my problem was simple but the manual just didn't deal 
with the problem. 

In your case, what appears to be an unexplainable error is 
caused by a simple glitch. You named the program with a ".c" 
extension. The compiler took this to mean that your program was 
to be compiled as a C program. Inside the iostream.h file are 
several C++ syntactic constructs (such as class). The compiler 
reported error messages for these constructs since they do not ex- 
ist in C. If you had named the program with a xpp extension, the 
compiler would have cleanly compiled the program. You might 
have been confused if you compiled other C++ programs without 
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errors and therefore you thought there was something wrong with 
this program. Many compilers (such as Borland), have a switch 
that compiles .c files as C++ programs. If this option was set in 
your configuration file for previous programs, then other C++ pro- 
grams with x extensions would have compiled properly. If you 
switched around directories or reinstalled the compiler, the switch 
may have been reset. 

There are numerous books out on C. Many are based on your 
knowledge of other languages. My book C Language for Pro- 
grammers (QED) gives comparisons of C constructs with CO- 
BOL, PASCAL, PL/1, BASIC, and FORTRAN. My new book C 
Language for COBOL Programmers (QED) presents very detailed 
comparisons between COBOL language statements and C. All on 
C (Harper Collins) explains C without comparisons to other lan- 
guages, but with numerous examples. In the C++ arena, I suggest 
C++ Programming and Fundamental Concepts by Anderson and 
Heinze (Prentice-Hall). I use that book as a supplementary book 
for my C++ courses. 

User interface 

QI am new to the C language and am having a problem 
that you might help me with. I am writing a football card 
data base, and need help with the user interface. What I am trying 
to do is let the user of my program enter required information 
without pressing the enter key. I also want the user to be able to 
move from one data entry field to another using the arrow and 
home keys of the key pad. If the user presses the arrow keys the 
highlighted field would move up or down as required, but if a 
letter key or a number key was pressed, the letter or number 
would be concatenated to the appropriate char string variable. The 
concatenating part I can handle. It's getting the input that's giving 
me the problem. I've tried many different approaches to make this 
work, but still no luck. If you could help me with this problem I 
would be very grateful. I'm a subscriber to the C Users Journal, 
and will be checking the Questions & Answers section to see if 
you can solve my problem. I am using Borland C++ version 3.0 
(DOS). 

Randy Jones 
Ruther Glen, VA 

A As you have discovered, data-field entry functions are not 
included in the Standard C libraries. Numerous shareware 
and commercially-available libraries will perform the operations 
you list. For a listing of available shareware consult The C User's 
Group Public Domain Catalog [available for free upon request 
from R&D Publications, 1601 W. 23rd St., Lawrence, KS 66046. 
Ph: (913)-841-1631. Fax: (913)-841-2624. e-mail: cu- 
jsub@rdpub.com. Perusing The C Users' Journal itself will reveal a 
number of the major vendors of display packages. Since for the 
past year I have been programming almost exclusively in Mi- 
crosoft Windows using Visual C++, I haven't kept up with all the 
different features of the commercial packages. Many of these 
packages have integrated screen designers/code generators. With 
such a system, you can layout your screens with a mouse or cur- 
sor keys, rather than by writing individual function calls for each 
field. In case you can't find what you want in either the catalog or 
the ads, my book All on C shows a sample implementation of a 
package of display functions providing most of the features you 
requested. □ 
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Introduction 

I have been working on a large scale database downsizing pro- 
ject for the Ventura County School District since the beginning of 
1993. Recently we turned over to the users the first application, a 
teaching-credential tracking database. Instead of the ticker tape pa- 
rade we had expected, all they did was comment on how slow it 
seemed to run. Even though we used all the latest buzz words — 
such as "object-oriented" and "client-server" — we had to admit it 
was very sluggish. So we began an intense optimization effort, 
putting our application on a crash course of exercise and diet, to 
get it down to size and up to speed. This article deals with the 
potential problems facing object-oriented programming in C++ 
and some of the solutions we used. 

One of the major advantages to object-oriented programming is 
that it can hide complexity. Very complicated sub-systems can be 
wrapped by classes. These classes provide well defined interac- 
tions, making their objects relatively immune to environmental 
factors. The down side to this is that the application programmer 
may not be aware of all the ramifications of using an object. Ob- 
jects may encapsulate the acquisition of system resources, or they 
may create sub-objects. Just declaring a local variable can be a 
costly procedure. 



One problem that faced us early on was from a class of the 
Commonbase Database class library, DBTable. Just creating a vari- 
able of type DBTable had the side effect of opening a communica- 
tion channel (socket) to the database server. We were allocating 
DBTable objects from free store and in rare cases they never got 
deleted. Since our networking software had only 20 sockets avail- 
able, the application would run fine for a while and then run out 
of sockets. This is actually an old problem, familiar to C program- 
mers, but with a new twist: more than memory might be allocated 
by creating a user-defined type. Since this caused the program to 
die it was fixed early on, but other similar problems existed. We 
had to automate the creation of each DBTable, so as not to create it 
until it was needed, and to delete it as soon as possible. It could 
not be left up to the application programmer. 

Another side of complexity hiding is that an object may be a 
front for many sub-objects. One of our objects, BMOJoin (Business 
Model Object Join), contained a list of DBTables. A join is data- 
base jargon for a relational combination of tables. Since a DBTable 
holds one socket, a BMOJoin can hold many. To add to this prob- 
lem, another object, BMOIterator has a pointer to a BMOJoin. As I 
will explain later, the BMOIterator was the key to controlling all 
these resources, and minimizing their allocation. 



I 
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Another class, ACond, represents a logical condition. It is imple- 
mented as an expression tree. So doing a simple assignment of an 
ACond could be costly. Again this is actually an old problem, the 
only difference being that in C such copying can be done only by 
calling a function, while in C++ the function can be initiated with 
an assignment operator. C programmers know that calling a func- 
tion can take time and resources, but using built-in operators al- 
ways takes (relatively small) constant time and never takes system 
resources. These assumptions go out the window in C++. 

Free-store usage is another problem. Just opening a window 
and tieing it to a database in our application takes thousands of 
memory allocations, some of them just for a few bytes. Memory 
allocation is the lifeblood of C++ programming because objects 
should be made autonomous, and cannot rely on outside sources 
such as local or global variables for their internal memory space. 

A string class, for instance, typically contains a pointer to 
memory containing the string (see Figure 1). That memory must 
come from free store if the class is to be considered general pur- 
pose. If the memory came from outside the class, the string could 
not delete it when it was done, and the user would have to delete 
it if necessary. The issue of pointer ownership is important in 
making a safe application, and helps alleviate some of the com- 
mon C pointer troubles such as deleting memory twice, or forget- 
ting to delete it at all. It also means that memory allocation and 
copying may be done more often than absolutely necessary. 

Another problem introduced with object-oriented programming 
is over-generalization. With base classes one can provide the com- 
mon subset of functions available from a set of derived classes. If 
the programmer uses the base class, the full set of functions may 
not be available. An example of this is the use of a list object. A 
list object might be represented either by a linked list or by an 



array. If the programmer uses a list and needs to get to the n-th 
object, indexing may not be an option. The programmer will have 
to iterate through the list, keeping a count. If the programmer uses 
an array object, indexing is available. 

Another example of this is the use of a complex number class. 
The operation (2 + 0i) * (6 + 0i) can be calculated much 
easier as 2 * 6. Because the more general form is used, the opti- 
mization for a special case is missed. The ability to generalize is a 
major plus for C++, but can limit optimization. 

Code Bloat 

Another issue I deal with here is code bloat. I used to think a 
program was big if I had to leave small model (greater than 64 
kilobytes of code or data). Our current application is about 1.5 
megabytes and growing (from about 30,000 lines of code and two 
libraries). Part of this growth stems from the tendency to make 
objects all-purpose (or worse, multi-purpose). Poorly designed ob- 
jects often give liberal access to their internals, or multiple meth- 
ods of access. A well designed object should do one thing, one 
way, and do it well. The public interface should be minimal in 
order to guide the programmer to the expected usage, and to keep 
things simple. 

Making matters worse, currently the linkers I use (Borland's 
tlink and HP-UX Id) always link in all virtual functions even if 
they are never used. This is because all virtual functions are refer- 
enced in an object's virtual table, which is included with a class 
constructor. I have heard that new linkers are addressing this prob- 
lem, but without thorough evaluation of all the code, they will 
have trouble determining whether any one virtual function will 
assuredly be called (or assuredly not be called). 




Randy Kamradt has been programming in C/C++ for the past seven years. He is currently working for TEAM Software, a fashionably 
lean consutling company developing an integrated database package for the Ventura County Superintendent of Schools, in Ventura 
California. 
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Figure 1 Good objects must 

igement 



class BadString { 
public: 

// Using the pointer directly: 
BadStringtchar *s) { ptr = s; } 

// Where did pointer come from: 
-BadStringO { delete[] ptr; } 

private: 
char *ptr; 

}; 

char *strdup(const char *str) 
{ 

return strcpy(new 
char[strlen(str)+l],str); 

} 

class GoodString { 
public: 

// Don't use the pointer, copy it: 
GoodStringtconst char *s) 
{ ptr = strdup(s); } 
// Now you can safely delete it: 
-GoodString () 
{ delete[] ptr; } 
private: 
char *ptr; 

}; 

// End of File 



Another culprit in code bloat is the in- 
line function. In the C++ style of object- 
oriented programming, small functions are 
very prevalent, and inline functions are 
necessary for a well oiled program. The 
factor that should decide whether a func- 
tion is inline is the ratio of time spent call- 
ing the function to the time spent inside 
the function. If the time spent inside the 
function is much greater than the time 
spent calling the function, making it inline 



Figure 2 Using the profiler to 
find hidden , 




II why isn't the while loop 
// ever executed? 

time count 

0.0012 50 int flag = 0; 

0.0031 50 whiletflag = 0) 



{ 



if(doTilTrueO) 
flag • 1: 



// End of File 



won't help speed much and will simply 
contribute to excessive code size. This im- 
plies that to use inlines effectively one 
should be aware of the inner workings of 
the compiler, and all of the side effects 
caused by some C++ functions. 

One of the best ways to optimize is to 
use a profiler. I used the Borland Win- 
dows profiler extensively while optimiz- 
ing. In spite of its tendency to crash, or 
reboot my computer occasionally, it was a 
tremendous help not only in optimizing, 
but in finding bugs and memory leaks. 
The Borland profiler is interactive, much 
like a visual debugger. It allows you to 
stop the program at any point to examine 
statistics collected, to turn profiling on and 
off during a single run, and to selectively 
profile portions of the code. It provides 
time spent on a single line of code, and 
the number of times a single line is called. 
This can be very handy for finding hidden 
bugs (see Figure 2). 

Profiling event-driven programs can be 
a challenge since the main loop of the pro- 
gram may be inaccessible. The method I 
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Listing 1 

MemoryPool 



Defines class 



tfifndef MEMPOOLJ 
♦define MEMPOOLJ 

♦include <stddef.h> 

const CharSize = 8; 
const Pool Size = 
sizeof(unsigned long)*CharSize; 

class MemoryPool Link { 
private: 

friend class MemoryPool ; 
MemoryPool Li nk( si ze_t _size, 

MemoryPool Link *_next); 
-MemoryPool Li nk(); 
void *raalloc(size_t size); 
void free(void *, size_t size); 
unsigned long bits; 
MemoryPool Link *next; 
char *data; 

}; 

class MemoryPool { 

MemoryPool Link freeHead; 

MemoryPool Link usedHead; 

size_t size; 
public: 

MemoryPool ( si ze_t size); 

void *add(); 

void *malloc(); 

void free(void *); 

}; 

♦endif 
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used was to profile each of the main 
classes of the program individually. Since 
we keep all of the code for a class in one 
module, that meant compiling that module 
with the debugging option on. In the pro- 
filer I could then set a profile area on 
every line in the module. After running 
the program and doing a few transactions 
that would exercise the class I was profil- 
ing, the statistics window would show me 
where the most time was spent. I used this 
technique for finding candidates for inlin- 
ing and other optimizations. By profiling 
the main classes first, I was able to tell 
which of the sub-classes were in need of 
optimizing, focusing my effort where it 
was needed. 



Figure 3 Inlining virtual 




class Base { 
public: 
virtual void printO 
{ printfC'Base"); } 

h 



class Derivedl : public Base { 
public: 
virtual void printO 

{ 

// Base:. -printO can be inlined 
Base: :print(); 
printf ("Derivedl"); 

} 

it 

class Deri ved2 : public Base { 
public: 
virtual void printO 

{ 

// Base::print() can be inlined 
Base: :print(); 
printf ("DerivedD; 

} 

}; 

void function(Base *bp) 

{ 

// Doesn't know whether 
// to call Derivedl: :print() 
// or Derived2::printO, 
// won't inline: 
bp->print(); 

// Forced to call Base: :print(), 
// can inline: 

bp->Base::print(); 

Derivedl dlo; 
// Forced to call 
// Derivedl: :print(), can 
// inline: 

dlo. printO: 

} 

// End of File 
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There are some limitations on inlining 
virtual functions. If a virtual function is 
called via a pointer or reference to an ob- 
ject, the actual function that gets called de- 
pends on the original type of that object. 
The compiler cannot determine at compile 
time the correct function, and therefore it 
cannot inline it. Virtual functions that are 
called via an actual object, or ones that are 
explicitly called with the ;; operator, can 
be inlined (see Figure 3). In at least one 
case we changed a virtual function to a 
non-virtual function in order to take ad- 
vantage of inlining. This step must be 
taken with caution, however, possibly ad- 
justing for any change in functionality. 

The decision to inline doesn't need to 
be all or nothing for a function. There 
might be a situation where a function can 
be split apart to facilitate inlining. Figure 4 
shows that the member function Get- 
WidgetPointer gets called 10,000 times, 
but only has to create a Midget 10 times. 
By splitting this function in two, the part 
that gets executed 10,000 times can be in- 
lined, and the main part of the code can be 
isolated in a private member function. 
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Some special precautions should be 
taken when inlining constructors and de- 
structors. The compiler may add code that 
you didn't call explicitly. For example 
with an inline constructor, the compiler 
will also inline for you the setting of the 
virtual table pointer, calls to any base class 
constructors, and calls to constructors of 
any data members that have constructors. 
Borland C++ also adds code to check if 
the constructor is called on the behalf of a 
new statement and optionally calls a mem- 
ory allocation routine. The destructors will 
do the same. 

One more precaution for inlines, if the 
inline contains a function call, that func- 
tion call may also be inline, which may 
also contain an inline function, and so on. 
Make sure you know what you put inline. 
Just as an aside, some current compilers 
forget to call the destructors for local vari- 
ables in inline functions. This is important 
if the local variables hold memory or sys- 
tem resources and can cause a memory 
leak. For now I wouldn't create local vari- 
ables or pass-by-value user-defined ob- 
jects in an inline function. 
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Pointer Tricks 

One of the best ways to address rampant free-store allocation 
is by counting pointers. This is a simple but effective technique 
that can be used on any class to speed up assignments and passing 
by value. It is best targeted at utility classes that are used in many 
different places and cannot be isolated. 

A good example is a string class. I pointed out above that a 
class always allocating its own memory can lead to excessive 
memory allocation and copying. But if the string class contains a 
pointer to an intermediate data structure with a count, assignment 
becomes a simple matter of decrementing and incrementing a 
counter (see Figure 5). 



Graphics & Timing Tools 



BGI SVGA Video Driver Toolkit 



New Toolkit! 



Provides Super VGA driver support at up to 1280x1024x256 for most popular SVGA 
cards using the Borland BGI graphics library. Support for graphics mode mouse 
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BGI Font Toolkit 



New Toolkit! 
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By adding a little smarts to the string class we can reduce the 
amount of work done, but we don't have to change the external 
appearance of the class. It is important to maintain the external 
appearance if you need to change the class, but don't want to 
make changes to all modules that use the class. 

One problem still remains. If you assign stringl to string2, 
then modify stringl, String2 will also get modified. This prob- 
lem is solved by using "copy-on-write" semantics. Copy-on-write 
is a strategy where any member function of the string class that 
modifies the string will first call a function that splits off a private 
copy of the internal implementation (see Figure 6). 

In our application we use both pointer counting and pointer 
counting with copy on write. The class BMOIterator mentioned 
above uses pointer counting as a smart pointer. Besides construc- 
tors, assignment operators, and a destructor, the only member 
function is the overloaded operator->. An object used with this 
operator appears as simply a pointer (see Figure 7). In order to 
work intuitively as a pointer, we did not implement copy on write. 
Also, since a BMOIterator holds system resources, we judged it 
best that no copying should take place unless explicitly asked for. 

In another class, AttributeList, which is basically a list of inte- 
gers, we did implement copy on write. Since these AttributeLists 
are not often modified, adding copy on write doesn't add signifi- 
cantly to run time. However after running the AttributeList code 



Figure 4 Efficient inlining 



Figure 4a. Splitting functions to facilitate inlining. 



5.1274 10000 Widget *WidgetHome::GetWidgetPointer() 
{ 

1.0333 10000 if(w1dgetPtr == NULL) 

{ 

0.0012 10 widgetPtr = new Widget; 

0.0013 10 iftwidgetPtr == NULL II 

w1dgetPtr->1sError()) 
0.0000 return NULL; 

} 

1.0237 10000 return widgetPtr; 
3.5429 10000 } 



Figure 4b. Inlining only the part called most often. 

// the inline doesn't show up on the profile count: 
inline Widget *WidgetHome: :GetWidgetPointer() 



{ 



return widgetPtr ? 
widgetPtr : 

PrivateGetWidgetPointerO; 



0.0020 10 



0.0059 
0.0035 



0.0001 1 
// End of File 



} 



Wi dget *Wi dgetHome : : Pri vateGetWi dgetPoi nter( ) ; 

{ 

widgetPtr = new Widget; 
if(widgetPtr == NULL || 
widgetPtr->isError()) 
return NULL; 
return widgetPtr; 

I 
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Listing 2 Memory pool 
member functions 



#include "mempool .h" 

MemoryPoolLink:: 
MemoryPoolLink( 
size_t size, 
MemoryPoolLink *_next) 
: bits(01). 
data (new 

char[size*PoolSize]), 
next(_next) 

{ 

} ' 

MemoryPool Link: : 
-Memory Pool LinkO 

{ 

delete[] data; 

} 



class String { 
private: 
struct Stringlmp { 
char *ptr; 
unsigned count; 
Stringlmptconst char *str) 
: ptrtstrdup(str)), 
count(l) 

{ 



-StringlmpO 
{ 

delete[] ptr; 



} 

} *imp; 
public: 
String(const char *str) 
{ 

imp = new Stringlmp(str); 

} 

Stringtconst String &str) 
{ 

imp = str.imp; 
imp->count++; 

} 

// assignment is a little tricky 
String 8 

operator=(const String &str) 

{ 

// increment first in case 
// of assignment to self 

str.imp->count++; 
// be sure to clean up the old imp! 

if(--imp->count == 0) 
delete imp; 

imp = str.imp; 

return *this; 

} 

-StringO 
{ 

if(--imp->count == 0) 
delete imp; 

} 

}; 

// End of File 




Figure 6 Implementing copy 



on write 



class String { 

// the contents of the string 
// class from Figure 5. 



// this indexing operator could 
// modify the string 

char &operator[](int i) 

{ 

1f(imp->count > 1) 

SplitO; 
return imp->ptr[i]; 

} 

// This indexing operator won't 
// modify, don't split, 
char operator[](int i) const 

{ 

return imp->ptr[i]; 

} 

private: 
void SplitO 
{ 

// Create private copy: 
imp->count--; 
imp = new 
Stringlmp(imp->ptr); 

} 

}; 

// End of File 



Figure 7 Implementing smart 
pointers 



class BMOIteratorlmp; 

class BMOIterator { 
public: 

BMOIteratortconst char *dbname); 
BMOIterator(const BMOIterator &); 
BMOIterator & 

operator=(const BMOIterator &); 
-BMOIteratorO; 
BMOIteratorlmp *operator->() 
{ 

return imp; 

} 

private: 
BMOIteratorlmp *imp; 

} 

functionO 
{ 

BMOIterator itC'DBNAME") ; 
// AddCol is a memeber of 
// BMOIteratorlmp 

it->AddCol("table.coll"); 

} 

// End of File 
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being created, and much time being spent 
allocating arrays of zero length. To allevi- 
ate this situation, we established a special 
case where a zero-length list was repre- 
sented by a null implementation pointer 
(see Figure 8.). Copying and assignment 
are slightly longer but the default con- 
structor is simplified. Only after using the 
profiler did we become aware of this spe- 
cial case optimization. 

Overloading 

new and delete 

Another strategy for addressing mem- 
ory allocation bottlenecks is to overload 
the new and delete operators for a class. 
Using a special purpose memory alloca- 
tion algorithm rather than the general pur- 




class AttributeList { 
private: 

struct AttributeListlmp { 
int *Hst; 
unsigned count; 
AttributeListlmpO'nt * 
data, unsigned size) 

{ 

list = new int[size]; 
memcpydist.data, 

sizeof(int)*size); 
count = lj 

} 

} *ptr; 
public: 

AttributeListO 
{ 

// Empty list special case: 
ptr = NULL; 

} 

AttributeListtint *data, 
unsigned size) 



{ 



ptr = new 
AttributeListlmptdata. 
size); 

} 

AttributeListtconst 
AttributeList &a) 

{ 

// Now we have to check 
// for null: 

ptr = a. ptr; 

if (ptr) ptr->count++; 

} 



}; 

// End of File 



using a different heap for different alloca- 
tion sizes you can reduce the amount of 
time needed to search for a chunk of free 
memory, and reduce fragmentation as 
well. 

An example of this is presented in 
Listings 1-3, which implement a mem- 
ory-pool class and a linked list class that 
uses the memory pool. The memory-pool 
class is a heap for a specific size alloca- 
tion. It is used by associating one instance 
of the memory pool class with any class 
(via a static data member) and overloading 
the new and delete operators to use the 
pool. Since the specific new operator is 
only used for that class member, the size 
is always the same. 

The heap works by allocating 32 ob- 
jects at a time, and maintaining a bit map 



Figure 9 Delaying creation of 
an object by restricting access 



class BMOJoin; 

class BMOIteratorlmp { 
public: 

BMOIteratorlmpO 

{ 

itsJolnPtr = NULL; 

} 

-BMOIteratorlmpO 
{ 

delete itsJoinPtr; 

} 

int Searchtchar *str) 
{ 

return 

GetJoinPointer()->Search(str); 

} 

void Disconnect) 

{ 

delete itsJoinPtr; 
ItsJoinPtr = NULL; 

} 

private: 

// this is actually split apart 
// (see Figure 4.) 

BMOJoin *GetJoinPointer() 

{ 

If(itsJoinPtr) 

return itsJoinPtr; 
itsJoinPtr = new 

BMOJoindtsStoredParameters); 
if (itsJoinPtr == NULL) 
// for now throw is just an inline 
// for exitO 

throw(ErrNoMem) ; 
return itsJoinPtr; 

} 

u 

II End of File 



and the other for chunks that are com- 
pletely used up. Therefore the allocation 
logic has to search only one chunk for a 
free spot. (I have to thank my brother 
Mark for the bit searching method, with- 
out which this method was actually slower 
than the built-in malloc.) This special ver- 
sion of new could also be rewritten in as- 
sembly language for even greater speed. 

For classes that hold limited resources 
(such as our BMOJoin which controls one 
or more network sockets), a good strategy 
is to delay creation until the last possible 
moment. We used code similar to that in 
Figure 4b inside the BMOIterator, calling 
GetJoinPointer rather than accessing the 
BMOJoin pointer itself. In this way we can 
create BMOIterators as we put up a win- 
dow, but the BMOJoin isn't created until a 



Listing 2 continued 



void *MemoryPoolLink: :malloc( 
size_t size) 

{ 

static char lookup[] = { 
0. I. 0, 2. 
0, 1, 0, 3. 
0. 1, 0. 2. 
0, 1, 0, 4, 
}; 

1nt shift = 0; 
unsigned long b = bits; 
if((b&0xFFFF) == 0xFFFF) 
( 

shift = 16; 
b »= 16; 

} 

if((b&0xFF) == 0xFF) 
{ 

shift += 8; 
b »= 8; 

} 

1f((b&0xF) == 0xF) 
{ 

Shift += 4; 
b »= 4; 

} 

shift += lookup[b&0xF]; 
bits |= (11 « shift); 
return data + 
(shift * size); 

} 

void MemoryPool Link: :free( 
void *ptr, 
s1ze_t size) 

{ 

bits &= 
-(11 « 

((char *)ptr-data)/size); 
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Listing 2 continued 



MemoryPool : : MemoryPool ( 
size_t _size) 
: size(_s1ze), 

freeHead(0,NULL), 

usedHead(0,NULL) 

{ 
} 

void *MemoryPool : :add{) 
{ 

MemoryPool Link Hemp = new 

MemoryPoolLinktsize. 

freeHead.next); 
if (temp == NULL) 

return NULL; 
freeHead.next = temp; 
return 

freeHead.next-> 

malloc(size); 

} 

void *MemoryPool::malloc() 
{ 

if(freeHead.next) 
{ 

void *ret = 

freeHead.next-> 

malloc(size); 
if(freeHead.next->bits == 

OxFFFFFFFFL) 

{ 

MemoryPool Link *temp = 
freeHead.next; 

freeHead.next = 
temp->next; 

temp->next = 
usedHead.next; 

usedHead.next = temp; 

} 

return ret; 

} 

return add(); 



} 



void MemoryPool : :free( 
void *ptr) 

{ 

MemoryPool Link *temp = 

freeHead.next; 
MemoryPool Link *prev = 

SfreeHead; 
while(temp) 
{ 

ptrdiff_t diff = 

temp->data - 

(char *)ptr; 
if (diff > && 

diff < size*PoolSize) 

{ 

temp->free(ptr, size); 
if(temp->bits = 01) 

{ 

prev->next = 
temp->next; 
delete temp; 

} 

return; 

} 

prev = temp; 



Listing 2 continued 



temp = temp->next; 

} 

temp = usedHead.next; 
prev = HusedHead; 
whi let temp) 
{ 

ptrdiff_t diff = 

temp->data - 

(char *)ptr; 
if (diff > && 

diff < size*PoolSize) 

{ 

temp->free(ptr, size); 
prev->next ■ 

temp->next; 
temp->next = 

freeHead.next; 
freeHead.next = 

temp; 
return; 

} 

prev = temp; 
temp = temp->next; 

} 

} 

// End of File 



Listing 3 A linked list for the 



^include "mempool .h" 
#include <fstream.h> 
^include <string.h> 

class Link { 
char *data; 
Link *next; 

static MemoryPool pool; 
public: 
friend class List; 
friend class Iterator; 
Linktconst char *_data. 
Link *_next) 

{ 

next = _next; 
data = strcpy(new 

char[strlen(_data)+l], 

_data); 

} 

-LinkO 

{ 

delete data; 

} 

void * 
operator new(size_t) 

{ 

return pool .mallocO; 

} 

void 

operator deletetvoid *ptr) 

{ 

pool.free(ptr); 

} 

}: 



Listing 3 continued 



MemoryPool 

Link::pool(sizeof(Link)); 

class List { 

Link head; 
public: 

friend class Iterator; 

List 0: 

-ListO; 

void add(char *data); 

}; 

class Iterator { 

Link *link; 
public: 

IteratorUist &_list) 

{ 

link = J i st. head. next; 

} 

char *Next() 

{ 

char *ret = link ? 

link->data : NULL; 
link = link->next; 
return ret; 



ist::List() 
: head("",NULL) 



1st: :— Li st( ) 

whi lethead. next) 
{ 

Link *temp = 

head.next->next; 
delete head. next; 
head. next = temp; 

} 



void List: :add(char *data) 



{ 



head. next = new 
Link(data, head. next); 



) 



main(int, char **argv) 
{ 

static char buff [1024]; 
List list; 

ifstream in(argv[l]); 
while(in.getline(buff , 

sizeof(buff))) 

list.add(buff); 
Iterator it(list); 
char *ptr; 

while((ptr = it.NextO) != 
NULL) 

cout « ptr « endl ; 

} 

// End of File 
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search is performed. We added a member function called Discon- 
nect to the BMOIterator, and call it when a window is put into the 
background to delete the BHOJoin pointer and free resources for 
the foreground window (see Figure 9). 



Randy Kamradt 

Conclusion 

Finally, running the profiler through a particularly sluggish 
area, we discovered that a lot of time was being spent padding 
strings with spaces. The problem here was that operator^ for the 
string was not as efficient as we had hoped. By going to a lower 
level, and accessing C-style strings directly, we managed to speed 
up the padding process considerably. 

I should mention that a good string class would have had a 
padding function, or at least the ability to create a blank string of 
count bytes. This low-level access then wouldn't be necessary. 
Since the string class was part of a commercial library we didn't 
want to modify or add to it. It's good to know that all the old C 
tricks are available even if just used at the lowest levels. Credit 
has to be given here to the profiler for finding this bottleneck. 

Many of the optimizations described above are fairly simple 
because of the separation of interface from implementation. The 
idea is to be able to grease up a class without having to worry 
about side effects that might be possible in a less restrictive inter- 
face. Other optimizations are possible by dipping into C++'s C 
heritage as a low-level language. 

Of course there is no substitute for a good design effort up 
front. A temptation in design is to make a lot of "friendly" classes, 
which access each other's internals. But what you wind up with is 
"spaghetti objects." By maintaining integrity between classes, you 
can twiddle with the internal bits to your heart's content without 
having to worry about unforeseen side effects. □ 



Figure 1 Going low-level to improve efficiency 



Figure 18a. Results of an inefficient += operator. 

1.8235 588 void PadW1 thSpaces ( CStri ng &str, int count) 

{ 

5.8346 28888 wh1le(count--) 
38.8397 19888 str += " "; 
1.4354 588 } 

Figure 18b. Improved performance with low-level C-strings. 

1.8233 588 void PadWithSpaces(CString &str, int count) 
{ 

2.4585 588 char *tmp = new char[count+l]; 

3.2938 588 memsetttmp, ' '.count): 

8.9438 588 tmp[count] = '\8'; 

5.3849 588 str += tmp; 

1.9438 588 delete[] tmp; 

1.4353 588 } 

// End of File 
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Introduction 

On most computer systems, users interact with the system 
through command-language interpreters called shells. These shells 
accept user input and interpret them as commands for the system. 
There are three major UNIX shells: Bourne, C and Korn (kshell). 
Other shells include command.com for MS-DOS and for OS/2. 

The Korn Shell, which we consider here, offers sophisticated 
management of past commands (history). We have enhanced this 
functionality to include a learning automaton that predicts the next 
command. This command prediction often allows the user to avoid 
entering the command sequence in its entirety. In most of the 
computing environments we considered, this enhanced shell pre- 
dicted the next command with a high degree of accuracy. 

This article describes our shell enhancements and details some 
of the methods we used to implement them. Although the Korn 
Shell was our target shell, we have applied these same enhance- 
ments to the C Shell. We believe this article will show that our 
enhancements are applicable to other shells as well. 

Attaining Command Cycle Consciousness 

In our research we have found that most users exhibit cyclic 
behavior when interacting with an operating system. For example, 
to create and execute a program, users may produce the following: 



1. Command: Evoke editor — create the source file. 

2. Command: Create executable — compile & link the source file. 

3. Command: Execute the file created in (2) — examine the results. 

The user typically repeats this sequence until he or she has com- 
pleted and thoroughly debugged the program. 

If a shell can recognize such cyclical behavior (we say it has 
cycle consciousness) it can predict the user's next command at any 
point in the sequence. We incorporate cycle consciousness into the 
shell by integrating it with the Predictor module outlined in the 
next section. 

The Predictor Module 

To incorporate cycle-based knowledge into various operating 
system facilities, we have developed an abstract data type module 
called a Predictor (Listing 1). The Predictor is a learning automat- 
ion representative of the learning-from-analogy class of learning 
strategies. In learning-from-analogy strategies, the learner reaches 
a conclusion about the current case by considering previously 
processed cases bearing strong similarities to the current case. For 
the predictor module, the previously processed cases are the se- 
quences of commands already encountered from the command 
stream. 
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Listing 1 Definition of the Predictor 







enum ReturnValue 

{ 

Failure, 
Success 

}; 

const DEF_CARDINAL=500; 
const DEF_DELTA_CARDINAL=100; 
const MAX_SIZE_COMMAND=50; 

class predictor 
{ 

int n um_c omnia nds; 
int cardinal_a_matrix; 
int *ajnatrix; 
char *commands; 
int last_ordinal ; 



//number of commands ajnatrix can hold 
//increment of cardinal_a_matrix 
//maximum size of command 



//current number of unique commands 
//max number of commands ajnatrix can hold 
//pointer to the adjacency matrix 
//list of unique commands 
//index of last command 



ReturnValue size(int cardinality); 

int is_unique(char *command); 

ReturnValue inserttchar *command); 
ReturnValue updatetint ordinal); 

public: 

predictor 

{ 

num_commands=0; 

cardinal_a_matrix=DEF_CARDINAL; 
size(cardinal_a_matrix) ; 
last_ordinal=-l; 



//malloc or remalloc to create 
// approp. ajnatrix & commands 
//checks commands[] for command 
// <0 =>No,else=>index of command 
//add command to commands 
//increment ajnatrix entry 
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The Predictor module incorporates an 
abstract component as well as several con- 
crete components. The abstract component 
is the prediction algorithm, which we de- 
scribe shortly. The concrete components 
consist of three major classes: 

1. Control Class: The two instances of this 
class supply entry points for initializing 
and terminating the Predictor Module. 

2. Input Class: This class obtains the next 
command from external modules. 

3. Predict Class: This class makes predic- 
tions for the Predictor module, predic- 
tor can make two types of predictions: 

1) The next command 

2) When a particular command will 
next oc cur 

By creating a predictor class, we en- 
capsulate all cycle-dependent code and data, 
making it easier to modify. This method of 
encapsulation also permits the coexistence 
of multiple predictors. (Environments where 
multiple command streams exist require 
multiple predictors.) We describe the pre- 
dictor class in detail later in this article. 

The Algorithm 

For this discussion we say that a com- 
mand stream C is a sequence of N com- 
mands composed of M unique commands. 
These commands arrive at the predictor 
one at a time via the input interface. These 
commands determine the current state of 
the cycle (command stream). 

The predictor module maintains a 
weighted adjacency matrix A. A is an M x M 
matrix which represents a command stream 
C (this command stream dynamically in- 
creases in length as each subsequent com- 
mand arrives), where the i/th element A[i,j] 
is if command j never follows command i, 
or some positive integer indicating the num- 
ber of times command j follows command i. 
(Some readers may recogonize this imple- 
mentation as part of a semantic network.) 

To predict the next command, the algo- 
rithm locates the corresponding row for the 
latest command n in the adjacency matrix A. 
The algorithm then selects command i such 
that command i is: MAX(A[n,iJ) i=l,2..M 
(index of command i) and A[n,i] >1 

If such a command exists, the algorithm 
returns command i as the best prediction of 
the next command to occur. If no such com- 
mand exists, the algorithm returns indicating 
that the predictor module cannot predict the 
next command given its current state. 
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Listing 1 continued 



} 

predictor(int cardinality) //overload constructor 
{ 

num_commands=0: 

cardi nal_a_matrix=cardi nal i ty ; 
size(cardinal_a_matrix) ; 
last_ordinal=-l; 

} 

-predictorO //destructor 
{ 

cardi nal_a_matrix=B; 
free(ajnatrix); 
free( commands); 

} 

ReturnValue PutNextCommandUhar *); 
ReturnValue GetNextCommandtchar *); 
int WhenNextCommand(char *); 



ReturnValue predictor: :PutNextCommand(char *command) 



{ 



int ordinal ; 

i f { num_commands+l >= cardinal_a_matrix) //no space ? 
{ 

cardi nal_a_matrix+=DEF_DELTA_CARDINAL; 
if(size(cardinal_a_matrix)==Failure)//can not allocate space 
return(Failure); 

} 



if((ordinal=is_unique(command))==-l) 
{ 

if(insert(command) == Failure) 

return(Failure); 
ordinal=num_commands; 

} 

return(update(ordinal )); 



//command encountered before? 
//no - add it 

//new ordinal number of command 
//return appropriate value 



ReturnValue predictor::GetNextCommand(char *command) 
{ 

int ordinal ,roax=0,i ; 
int *last_command; 

//note: assumes ajnatrix is stored in row major fashion 

last_command=a_matrix+ //calculate row of last_command 

last_ordinal* 

cardinal_a_matrix*sizeof(int); //size of a row 
//Note: With certain compilers, sizeof(int) is unnecessary 



for(i=0; i<num_coranands; ++1) 
{ 



//do HAXO function 



if(*(last_command+i*sizeof(int))>max) 
{ 

max=*(last_command+i*sizeof(int)); 
ordinal =i ; 



} 



if(max>0) 
{ 

strcpyt command, coranands*HAX_SIZEJOHMAND); 
return(Success); 

} 

else 
{ 

comma nd=NULL; 
return(Failure); 
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Listing 1 continued 




} 

int predictor: :WhenNextCoiimand( char *coranand) 

r 
t 

int count=l; 

int old_last_ordinal=last_ordinal ; //save state of predictor 

int any_cyc1e[num_comniands]; //check to see if we have cycled 

int i ; 

char pcommand[MAX_SIZE_COMMAND]; 






//zero 

for(i=0; i<num_comnands ; ++i) 
any_cycle[i>0; 




whi 1 e ( GetNextComnand( command ) ==Succes s ) 
{ 

if(!strcmp(pcommand, command)) //found the command 
break; 






i=is_unique(pcommand) ; //find index of predicted command 
ifdany cyle[i] A l) //test and check 
{ 

count=0; //we have cycled - failure 
break; 

} 






++count; 

} 

return(count); 

} 






/* End of File */ 
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The algorithm performs the following 
steps to predict when a particular com- 
mand will next occur: 

1. Save the current state of the predictor 
module. 

2. Set count-O. 

3. Call the predict-the-next-command in- 
terface repeatedly until the return value 
command i is 

a) Equal to the specified command 

b) A value indicating that the predictor 
cannot make a prediction 

c) A value previously returned by the 
predict-the-next-command interface 
(this implies that the predictor as- 
sumes the command stream will cy- 
cle without an occurrence of the 
specified command). For each time 
the predict-the-next-command inter- 
face is called, increment count. 

4. Restore the original state of the predic- 
tor module. 

5. Return count if step 3 terminated be- 
cause of condition 3. a, otherwise return 
a value indicating that the predictor 
cannot predicting when the specified 
command will next occur. 

The Predictor Class 

The predictor class contains three 
publicly accessible functions to perform 
input and output: 

PutNextCommand — This function regis- 
ters commands occurring on the system. 
We modified the main control loop of the 
kshell to call this function whenever the 
kshell assembled a command and regis- 
tered it to provide "history" functionality. 
This function returns values corresponding 
to internal fatal errors and success. 

GetNextCommand — This function 
passes the next predicted command to the 
system, if it can be predicted. We aug- 
mented the kshell source to recognize 
when the user types ESC-p (in emacs 
mode) at the prompt, and to call 
GetNextCommand. As a result, the kshell 
produces either a beep (to indicate the in- 
ability to predict the next command) or a 
command string adjacent to the prompt, 
which the user may execute by typing a 
carriage return. 

UhenNextCommand — As its name im- 
plies, this function predicts when a par- 
ticular command will occur. We do not 
use this function in the kshell. We have 
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included it in the predictor module be- 
cause it is invaluable in other systems that 
require this kind of prediction, (e.g. in a 
file caching system — when a file needs 
"flushing," information about when a file 
will next be used is advantageous.) This 
function returns zero to indicate that the 
command stream will cycle before it en- 
counters the specified command. This 
function returns a value of less than zero 
to signal an internal error. 

These last two functions maintain and 
manipulate the adjacency matrix men- 
tioned previously. 

Results 

To show how well the predictor works, 
we have derived the following examples 
from a command stream in a programming 
environment. Figure 1 shows the first ex- 
ample. The first column shows the actual 
command stream. The second column, 
with the prefix p: shows the predicted 
command stream. The last two columns 
show the current percentile of successful 
predictions and the maximum percentile of 
successful predictions, respectively. The 
second example (Figure 2) differs from 
the first only by one command; we have 
removed this command, Is, from the 
stream in example 2. This command rep- 
resents an "exception" to the cyclical na- 
ture of the command stream. Thus, exam- 
ple 2 shows the effect of filtering out ex- 
ceptions. 

Open Issues: 

To keep this article consice several 
items have not been sufficiently devel- 
oped. The following are a few points that 
we believe require further clarification. 

How are command parameters 
handled? 

Commands can be classified as either 
tightly coupled or loosely coupled with 
their parameters. The degree of coupling 
is context dependent. For instance, when 
the predictor is used in a file caching sub- 
system, predicting the sequence of pa- 
rameters (e.g. file names) is more impor- 
tant than predicting the sequence of the 
commands themselves. We say the com- 
mands are loosely coupled. In the case of 
tightly coupled commands, we treat parame- 
ters and their commands as one predictor 
unit, that is, the predictor considers the 
same command with different parameters 

The C Users Journal — March 1 994 



Anatomy of a Command Shell 



In most systems, user programs 
and system programs are executed by 
the command-language interpreter. In 
more sophisticated systems such as 
UNIX, there are no major distinctions 
between this interpreter and any other 
program — so users can easily create 
their own shells. 

The shell actually executes a com- 
mand by completing a fork, after 
which the child process executes an 
execve (load and execute) of the com- 
mand. The parent process (the shell) 
does a wait and suspends its own exe- 
cution until the child process finishes 
executing and performs an exit. In 
multi-tasking systems, such as UNIX, 



both the shell and the command it is 
processing can execute concurrently. 
Users can initiate concurrent execution 
by typing a command followed by an 
ampersand. The shell interprets this 
symbol as an indication not to perform 
the wait; instead the shell continues 
with the next step in its command in- 
put by prompting the user for the next 
command. 

This capability implies the exist- 
ence of a fairly sophisticated inter- 
process communication system. As a 
bare minimum, a child process needs a 
method to signal its termination to the 
parent process (the shell), which is not 
necessarily polling for this signal. □ 



THERE IS NO SUCH 
THING AS A FREE MAKE! 

Why pay for a Make utility when one comes free with your compiler? Be- 
cause the moment you start using it you start paying for it. You pay with your 
time, effort and frustration in trying to keep your software projects up-to-date. 

Opus Make excels where your Make falters. For large projects and interfacing 
to version control systems, for transparent handling of your Microsoft and 
Borland makefiles, for PolyMake makefile processing at twice the speed for half 
the price, for exceptional technical support at no additional charge, Opus Make 
version 6.0 is the only economical choice. 

Your time isn't free. Neither is your sanity. Find out why Andrew Binstock says 
" Opus Make is the most compelling reason for not using the make 
utilities bundled with today's compilers." 
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Example 1: 

Original Command Stream Predicted Command Stream 



o:cc -o timer timer. c 


P: 


00* 


00* 


o:timer 




N 


00* 


00* 


o:l s -1 timer 




P: 


00* 


00* 


***Removed from example 2**** 






o:vi timer. c 




P = 


00% 


00* 


o:cc -o timer 


timer. c 


p:cc -o timer timer. c 


*16* 


16* 


o:timer 




p:timer 


*zs% 


28* 


o:vi timer. c 




p : 1 s -1 timer 


25* 


28* 


o:vi tstin 




p:cc -o timer timer. c 
P: 


22* 


28* 


o:cc -o timer 


timer. c 


20* 


28* 


o:vi tstin 




p:timer 


18* 


28* 


o:vi timer. c 




p:cc -o timer timer. c 


16* 


28* 


o:cc -o timer 


timer. c 


p:cc -o timer timer. c 


*23* 


28* 


o:timer 




p:timer 


*28* 


28* 


o:vi timer. c 




p:vi timer. c 


*33* 


33* 


o:cc -o timer 


timer. c 


p:cc -o timer timer. c 


*37* 


37* 


o:timer 




p:timer 


*41* 


41* 


o:vi timer. c 




p:vi timer. c 


*44* 


44* 


o:cc -o timer 


timer. c 


p:cc -o timer timer. c 


*47* 


47* 


o:timer 




p:timer 


*50* 


50* 


o:vi timer. c 




p:vi timer. c 


*52* 


52* 


o:cc -o timer 


timer. c 


p:cc -o timer timer. c 


*54* 


54* 


o:timer 




p:timer 


*56* 


56* 


o:vi timer. c 




p:vi timer. c 


*58* 


58* 


o:cc -o timer 


timer. c 


p:cc -o timer timer. c 


*60* 


60* 


o:timer 




p:timer 


*61* 


61* 


o:vi timer. c 




p:vi timer. c 


*62* 


62* 


o:cc -o timer 


timer. c 


p:cc -o timer timer. c 


*64* 


64* 



Virtuoso TM 

Giving you the time to design in real-time. 



Virtuoso delivers ! Ported from 8bit microcontrollers to parallel pro- 
cessing systems with thousands of 32bit DSPs. Ease of use, superfast 
performance, high reliability and value for money. Includes source code, 
1 2 months support and maintenance. Ask for full details and availability. 

Virtuoso Nano 

The fastest and smallest multi-tasking kernel for DSPs. Process switch- 
ing and services in < 1 microsecond. Stdio. Network wide messages. 

Virtuoso Micro 

A high level but small preemptive real-time kernel with fully distributed 
semantics for transparent parallel programming. An industries' first with 
built-in cross development capability in C on any target ! With task level de- 
bugger, tracing monitor, stdio, etc. Free license for use under DOS. 

Virtuoso Classico 

A seamless integration of Virtuoso Nano and Micro. A must for parallel 
processing systems. The real-time O.S. that really works for DSPs. 

Virtuoso Modulo 0, 1, II, III, TV,V,VI 

A wide range of optimized libraries and support tools for DSP (> 1000 
functions, stdio, PC graphics, plotting, heap allocation, loader, etc.) 



Worldwide distributed, our open distribution policy welcomes new repre- 
sentatives and Value Added Resellers. Join the Virtuoso concept now ! 

Intelligent Systems International. Tel. (+32). 16. 62. 15. 85. 

Fax (+32). 1 6.62.1 5.84. e-mail : virtuoso@bix.com 



either parse the parameters out and use them as distinct predictor 
units, or, as is usually more beneficial, we still treat command-pa- 
rameter sets as tightly coupled and treat them as single predictor 
units. 

Are command cycles common? 

Yes. When we remove a lot of the "noise" from command 
streams, we find that most of the commands are members of com- 
mand cycles. The "noise," we have discovered, comes in many 
forms. Many command streams are sprinkled with commands we 
isolate as "exceptions." These exceptions would be commands like 
Is, dir, who etc. Users tend to use commands like these with 
enough randomness that it is easy to filter these commands out of 
otherwise perfectly healthy command streams. Another form of 
noise is the partial cycle. The partial cycle is best illustrated using 
the example session. In the edit-compile-execute cycle mentioned 
above, evoking the compiler sometimes results in errors that re- 
quire the user to re-visit the editor without completing the cycle. 
Partial cycles are much harder to deal with than exceptions and, 
consequently, our success rate with these tends to be lower. 

GUI Environments 

We have also begun investigations into incorporating cycle 
consciousness into graphical user interface (GUI) environments. 



Patching the Korn Shell 

The kshell source we started with was PD KornShell 
written by Eric Gisin <egisin@mdth.UUdterloo.EDU>. PD 
Korn Shell installs on 4.2+ BSD System V, and POSIX- 
compatible systems. PD KornShell assumes you have 
Standard C (ANSI) and POSDX header files and functions. 
The PD KornShell source is available on several Internet 
locations including: 

ftp.uu.net (192.48.96.9) 

/usenet/comp. sources. amiga/volume91/shells and 
softul.ncu.edu.tw (140.115.19.11) 
/pub5/tarz 

We assembled the kshell on an HP-UX machine using 
HP's C++ compiler. On the HP-UX system, which is a 
hybrid UNIX system (System V & BSD), only a negli- 
gible amount of source modification was needed to get the 
shell up and running. Since the source was in "public-do- 
main UNIX-type" C, we decided to leave the original 
parts in C and incorporate our enhancements in a C++ 
class. To facilitate the intermingling of C and C++, we 
instructed the C++ compiler to suppress name mangling 
(See "Using C/C++ with Clipper" by Mark W. Schumann 
in the December 1993 issue of CUJ for a thorough treat- 
ment of name mangling in C++). □ 
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The essential problem here is defining a command primitive. In a 
command-oriented interface a command primitive is well defined, 
but in a modern GUI a command primitive is more loosely de- 
fined and may incorporate several user actions, such as mouse 
moves and button clicks. User activity is hard to partition into 
distinct commands. 

Conclusion 

As in any article of this nature, we had to summarize a large 
body of work both theoretical and experimental to present here. 
The algorithm presented here is a first-degree learning automaton. 
We have added several filters and general enhancements to this 
automaton resulting in several different predictors that, depending 
on the situation, are selected and evoked at run time (late binding 
— virtual functions). Our work leveraged the predictor across 
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o:timer 


pttimer 


*65% 


65% 


o:vi timer. c 


p:vi timer. c 


*66% 


66% 


o:cc -o timer timer. c 


p:cc -o timer timer. c 


*67% 


67X 


o:timer 


p:timer 


*68% 


68X 


o:vi timer. c 


p:vi timer. c 


*69% 


69X 


o:cc -o timer timer. c 


p:cc -o timer timer. c 


*70% 


70% 


o:timer 


p:timer 


*71% 


71X 


o:vi tinier. c 


p:vi timer. c 


*72% 


72X 


o:cc -o timer timer. c 


p:cc -o timer timer. c 


m% 


72X 


o:timer 


p:timer 


*73% 


73X 


o:vi timer. c 


p:vi timer. c 


*74% 


74% 


o:cc -o timer timer. c 


p:cc -o timer timer. c 


*75S 


76% 


o:timer 


p:timer 


*75» 


75% 


o:vi timer. c 


p:vi timer. c 


*76% 
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o:cc -o timer timer. c 


p:cc -o timer timer. c 
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o:timer 


pttimer 
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77% 


o:vi timer. c 


p:vi timer. c 


*77X 


77% 


o:cc -o timer timer. c 


p:cc -o timer timer. c 


*78% 


78% 


ortimer 


p:timer 


*78X 


78% 


o:vi timer. c 


p-.vi timer. c 


*79% 


79% 


o:timer 


p:cc -o timer timer. c 


77X 


79% 


o:vi timer. c 


p : vi timer. c 
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79% 
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p:cc -o timer timer. c 
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79% 


o:vi timer. c 


p:vi timer. c 
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o:cc -o timer timer. c 


p:cc -o timer timer. c 


*77% 


79% 


o:timer 


p:timer 
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79% 


o:vi timer. c 


p: vi timer. c 


*78% 


79% 


o:timer 


p:cc -o timer timer. c 


76X 


79% 


o:mai 1 


p:vi timer. c 


75X 


79% 


o:remsh rigel 


P: 


74X 


79% 


o:vi timer. c 


P = 


72X 


79% 


o:cc -o timer timer. c 


p:cc -o timer timer. c 


*73X 


79% 


o:timer 


p:timer 


*73X 


79% 


o:vi timer. c 


p:vi timer. c 
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79% 


o:cc -o timer timer. c 


p:cc -o timer timer. c 
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79% 


o:vi timer. c 


p:timer 


73X 


79% 


o:cc -o timer timer. c 


p:cc -o timer timer. c 


*73X 


79% 


o:more $i nc/set jrap. h 


p:timer 


72X 


79% 


o:vi timer. c 
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71X 


79% 


o:cc -o timer timer. c 


p:cc -o timer timer. c 
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o:cc -o timer timer. c 


p:cc -o timer timer. c 
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o:cc -o timer timer. c 


p:cc -o timer timer. c 
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o:timer 


p:timer 


*71X 
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o:vi timer. c 


p:vi timer. c 
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o:cc -o timer timer. c 


p:cc -o timer timer. c 


*72X 
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p:timer 


*72% 
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p: vi timer. c 
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Sin gle and Double Linked Lists - cut, copy, insert and append entire list 
selections. Plus: sorted lists, circular lists, Add, Insert, Append, Delete, Search, 
Next, Previous, and more. 

Hash Tables - linked list or binary tree collision resolution and definable 
hashing functions. 

Multi-dimensional Dynamic Arrays - allocate single or multiple 
dimension dynamic arrays of any type. Quick sort, linear search and binary 
search can be used on the arrays. 

Binary and AVL Balanced/Threaded Trees - includes several routines 
for easily managing binary trees. The AVL balanced and threaded tree has all 
the functionality of a disk-based B-Tree, including: Add, Delete, GetEqual. 
GetEqGr, GetGreater, GetEqLs, GetLess, GetFirst, GetLast, GetNext, 
GetPrevious, and more. 

Slacks. Queues. Dequeues. Priority Queues. Sets. Bags and Graphs 

- allow the choice of a linked list of items, or an array of items for a tighter fit. 

Definable Memory Handlers - allow user-defined memory allocation 
routines for third-party memory managers. You can access all the memory 
you want! 

C/C++ Exception Handling - all MemSL functions are designed with 
plenty of exception handling. Exceptions can be handled for out-of-memory 
conditions, out-of-range conditions and improper-use conditions. Exception 
handlers can also be used for warning conditions, and more. 

C++ Templates - includes plenty of inline functions and the choice between 
template and non-template functions. The MemSL can also be compiled to 
inherit from an object class. 

And Much. Much More - the functions and functionality listed here are only 
a partial list of the MemSL. The MemSL was designed to be portable and very 
simple to use. No knowledge of data structures is necessary when using the 
MemSL. 
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several operating-system elements including memory management, 
schedulings and disk allocation. Overall, we think our assertions for 
incorporating cycle consciousness have been well founded. We have 
had favorable results in the areas we have studied. □ 

References: 

Peterson, James L.; Silberschatz, Abraham, Operating System 
Concepts, Addison- Wesley Publishing Co, 1985. 

Tanimoto, Steven L., The Elements of Artificial Intelligence, 
Computer Science Press, 1990. 

Thomas, Philip K., Rotenstreich, Shmuel, "Command Cycles," 
Ph.D. Dissertation, George Washington University, 1993. 



Figure 2 The sample session with an exception 
removed 


Example 2: (Without Is) 






Original Command Stream Predicted Command Stream 


o:vi timer. c 


Pi 


00% 00% 


o:cc -o timer timer. c 


P: 


00% 00% 


o:timer 


P: 


00% 00% 


o:vi timer. c 


P: 


00% 00% 


o:cc -o timer timer. c 


p:cc -o timer timer. c 


*20% 20% 


o: timer 


p:timer 


*33% 33% 


o:vi timer. c 


p:vi timer. c 


*42% 42% 


o:vi tstin 


p:cc -o timer timer. c 


37% 42% 
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Figure 2 continued 

















cc -o timer timer. c 
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P 


cc -o timer timer. c 
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A 00/ 
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cc -o timer timer. c 
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cc -o timer timer. c 
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timer 
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vi timer. c 
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cc -o timer timer. c 


P 


cc -o timer timer. c 
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timer 
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vi timer. c 
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vi timer. c 
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cc -o timer timer. c 
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cc -o timer timer. c 
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vi timer. c 
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cc -o timer timer. c 


P 


cc -o timer timer. c 
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vi timer. c 
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cc -o timer timer. c 
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cc -o timer timer. c 
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cc -o timer timer. c 


*73% 


73% 





timer 


P 


timer 


*74% 


74% 





vi timer. c 


P 


vi timer. c 


*75% 


75% 





cc -o timer timer. c 


P 
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The Return Types of Virtual Functions 



WG21+X3J16, the joint ISO ANSI C++ technical committee, 
is now in its fifth year of work on a standard definition for the 
C++ programming language and its accompanying library. Over 
the years, the committee has added more than a dozen new fea- 
tures to the language. I described several of them: 

• templates 

• exception handling 

• new keywords and digraphs to sup- 
port European translation environ- 
ments 

• wchar_t as a keyword 

• function and operator overloading for 
enumeration types 

• operator new[] and operator de- 
lete[] for array allocation 

in "Recent Language Extensions to 
C++", CUJ, June 1993, and described 
one other: 

• forward declaration of nested classes 
in "Nested Classes", CUJ, July 1993. 
This month, I'll explain another exten- 
sion: 

• relaxed restrictions on the return 
types for virtual functions 
This feature enhances the language's 

support for object-oriented program- 
ming. In particular, it extends the set of 
valid conversions within a type hierarchy 
that you can write without casting. I as- 
sume you are familiar with virtual func- 
tion in C++, which I described in my last 
three columns (see "Virtual Functions," 
"How Virtual Functions Work," and 
"Overloading and Overriding" in CUJ, December, 1993 through 
February, 1994). 

What the ARM Says 

According to the The Annotated C++ Reference Manual 
(ARM) (Ellis and Stroustrup [1990]), a member function de- 




clared in a derived class D overrides a virtual function in its base 
class B only if that function in D has the same name and signature 
(sequence of parameter types) as the function it overrides. Clearly, 
if the name of a function, say f, declared in D differs from the 
name of every function declared in B, then f doesn't override any- 
thing, f's declaration adds a new name to the scope of D. If D 
declares a function with the same name, again say f, as one or 
more functions inherited from B, but D's 
f has a signature that differs from the 
signatures of every f function in B, then 
again D's f doesn't override anything. In 
this case, D's f hides all of B 's f func- 
tions while in the scope of D. This is not 
an error, but as I explained last month, 
the resulting behavior might surprise 
you. Consequently, many C++ compilers 
issue a warning when this sort of hiding 
occurs. 

What about differing return types? 
According to Section 10.2 of the ARM: 
"It is an error for a derived class func- 
tion to differ from a base class virtual 
function in the return type only." For ex- 
ample, in 

class B 



{ 

public: 
virtual 



int vf(int); 



}; 

class D 
{ 



public B 



void vf(int); // error 



}; 



Dan Saks is the president of Saks & Associates, which offers consulting and training in C++ and C. He is secretary of the ANSI and ISO 
C++ committees. Dan is coauthor of C++ Programming Guidelines, and codeveloper of the Plum Hall Validation Suite for C++ (both 
with Thomas Plum). You can reach him at 393 Leander Dr., Springfield OH, 45504-4906, by phone at (513)324-3601, or electronically at 
dsaks@wittenberg.edu. 
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the declaration of D::vf is an error because it has the same name 
and signature as a function declared in B, but B::vF and D::vF 
have different return types. 

Consider the consequences of allowing different return types in 
this situation. A function g that accepts a formal parameter of type 
B * or B & can apply vf to that B object, as in 

void g(B *bp) 
{ 

if (bp->vf(0) > 1) 
} 

When compiling this function, the compiler considers only the 
definition for class B. None of the classes derived from B need to 
be declared when compiling g. Based on the static type of B: : vf, 
the call bp->vf(0) in g should be just fine; it returns an int, as the 
/ f statement in g apparently expects. 

Since D is publicly derived from B, you can pass a D * to ff, as 



But now if D::vf has a void return, how can the call bp->vf(0) 
possibly return an /flt? It can't, which is why the ARM insists 
that an overriding virtual function must have the same return type 
as the function it overrides. 



Cloning Objects 



Some members of the standards committee suggested that this 
rule is more restrictive than it needs to be. There are, in fact, le- 
gitimate circumstances where the return types of the overridden and 
overriding functions need not be absolutely identical. Clone functions 
are one such circumstance. 

Some applications need to be able to clone an object, that is, 
create an object that's an exact copy of another object. Typically, 
you implement a class X with a cloning function as something like 

class X 
{ 

public: 

X *clone() const 

{ return new X(*this); } 



D d; 
g(&d); 
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}; 



Inside X: -.clone, *this is an expression of type X that desig- 
nates the object being cloned. The expression new X(*this) allo- 
cates a new X object and initializes it using X's copy constructor 
(the X constructor that takes an argument of type X). clone is a 
const member function because it does not alter *this, and should 
thus apply to const as well as non-const objects. 



Listing 1 A class hierarchy with virtual cloning 
functions that have identical return type 



'shape' 



// 

// base class 
// 

class shape 
{ 

public: 

enum palette { BLUE, GREEN, RED }; 
shapetpalette c); 
virtual double areaO const = 0; 
virtual shape *clone() const = 0; 
palette colorO const; 
virtual const char *name() const = 0; 
virtual ostream &put(ostream &os) const; 
private; 

palette _color; 

static const char *color_image[RED - BLUE + 1]; 
}; 



// 

// class 'circle' derived from 'shape' 

// 

class circle ; public shape 

{ 

public: 

circletpalette c, double r); 
double areaO const; 
shape *clone() const; 
const char *name() const; 
ostream 4put(ostream ios) const; 
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new X returns an X *. Although you could write a clone func- 
tion that returns an X or an X &,l suggest returning X * to empha- 
size that clone returns a dynamically-allocated object that should 
be deleted eventually. In general, for any class X, the return type 
of X: -.clone should be X *. For example, in a library of geometric 
shapes, circle::clone should return a circle * and rectan- 
gle: -.clone should return a rectangle * 

When used in a class that's the root of a polymorphic hierar- 
chy, clone functions should be virtual, and often pure virtual. 
This lets you clone an object without knowing its exact type. For 
example, Listing 1 shows a polymorphic hierarchy of shapes simi- 
lar to the one I presented three months ago (see "Virtual Func- 
tions", CUJ, December 1993). Classes 
circle, rectangle, and triangle are all 
derived from base class shape, shape de- 
clares a pure virtual clone function as: 



virtual shape *clone() const = 0; 

Each of the derived classes overrides 
the clone function with an impure defini- 
tion. For instance, class circle declares 

virtual shape *clone() const; 

in the class definition, and later defines 

shape *circle::clone() const 
{ 

return new circle(*this); 
} 

Not long ago I said that, in general, a 
clone function for a class X should have a 
return type of X *. But here the return type 
of circle:: clone is shape * not circle 
*. According to ARM, circle:: clone must 
return a shape * because that is the return 
type of the function it overrides. Nonethe- 
less, this clone function is still quite useful. 

Circle: -.clone returns the result of new 
circle, which is indeed a circle *. Since cir- 
cle is publicly derived from shape, a circle is 
a shape, so the circle * in the return expres- 
sion converts safely and quietly to the return 
type shape *. A similar conversion occurs in 
the clone functions for rectangle and triangle 
shown in Listing 1. An application can clone an 
arbitrary shape with code such as: 

shape *s; 

shape *cs = s->clone(); 

which leaves cs pointing to an object that has 
the same dynamic type and value as *S. 

Listing 2 shows a more elaborate ex- 
ample dealing with collections of shapes 



implemented as arrays of pointers. The clone_all function repli- 
cates an entire collection of shapes. First, it allocates a new array 
to hold the pointers to the shape clones. Then, for each shape in 
the original collection, it clones that shape (using its virtual clone 
function) and places the pointer to the copy into the new array. As 
is always the case with polymorphic objects, it doesn't matter to 
clone_all how many different shapes there are; each shape knows 
how to clone itself. 

Unnecessary Downcasting? 

The ARM's requirement that the return type of an overriding 
function must be the same as the return type of the function it 
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overrides apparently doesn't pose any problems when dealing with 
pointers (or references) to objects at the root of the hierarchy, as 
in Listing 2. However, it often necessitates using casts when deal- 
ing with pointers to objects of other types in the hierarchy. For 
example, you cannot write 

rectangle *r; 

rectangle *cr = r->clone(); 



private: 

double radius; 
}; 

shape *circle::clone() const 

{ 

return new circle(*this); 

} 



// 

// class 'rectangle' derived from 'shape' 

// 

class rectangle : public shape 

{ 

public: 

rectangletpalette c. double h, double w): 
double areaO const; 
shape *clone() const; 
const char *name() const; 
ostream &put(ostream &os) const; 
private: 

double height, width; 
}; 

shape *rectangle::clone() const 

{ 

return new rectangle(*th1s) ; 

} 



// 

// class 'triangle' derived from 'shape' 

// 

class triangle : public shape 

{ 

public: 

triangle(palette c, double si, double s2, double a); 
double areaO const; 
shape *clone() const; 
const char *name() const; 
ostream &put(ostream 4os) const; 
private: 

double sidel, side2, angle; 
}; 

shape *triangle::clone() const 

{ 

return new triangle(*th1s); 

} 



// End of File 
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because r->clone() returns a shape * Even though a rectangle is 
a shape, a shape is not necessarily a rectangle. Therefore, you 
must add a cast, as in 

rectangle *cr = (rectangle *)r->clone(); 

Casts are dangerous things. They tell the compiler to stop com- 
plaining and let you do what you want to do, or at least, what you 
think you want to do. But compilers are right more often than we 



Stepping Up to C++ 

care to admit. Casts indicate that you are doing something that is 
generally unsafe. Thus, you really should avoid casts in your C++ 
programs, probably even more so than in C programs. When casts 
are rare, the few casts you really do need will stand out and draw 
more scrutiny, which they deserve. (For more about avoiding 
casts, see Plum and Saks [1991].) 

Of course, you don't really need a cast in the previous exam- 
ple, because you don't really need to call clone to replicate a 
shape that you know is a rectangle. Rather, you can simply clone 
*r with 




// 'clone_all' clones shape array 'sal' with 'n' 

// elements 

// 

shape **clone_all (shape *sal[], size_t n) 
{ 

shape **sa2 = new shape *[n]; 
for (s1ze_t 1 = 8: 1 < n; +H) 
sa2[1] = sal[1]->clone(); 
return sa2; 
} 

// 

// 'largest' returns the shape with the largest 
// area from shape array 'sa' with V elements 
// 

shape *largest(shape *sa[], s1ze_t n) 
{ 

shape *s = 0; 
double m = 0; 

for (s1ze_t 1 = fl; 1 < n: ++1) 
if (sa[1]->area() > m) 
{ 

m = sa[i]->area(): 

s = sa[i]; 

} 

return s; 

} 

int ma1n() 
{ 

const 1nt N = 4; 
shape *s[N]; 
shape *ls; 

s[B] = new circle(shape::RED, 2); 

s[l] = new triangle(shape::BLUE, 5, 6, as1n(0.8)); 

s[2] = new rectangletshape: :RED, 3, 4); 

s[3] = new circle(shape::GREEN, 3); 

cout « "The shapes are:\n"; 

for (int i = 8; i < N; ++1) 

cout « i « ")\t" « *s[1] « 'Vn'i 
cout « '\n'; 

shape **cs = clone_all(s, N); 
cout « "The cloned shapes are:\n"; 
for (1 = 0; 1 < N; ++1) 

cout « i « ")\t" « *cs[1] « "\n'i 
cout « '\n'; 
Is = largest(cs, N); 

cout « "The shape with the largest area is a...\n\t"; 
cout « *ls « "An"; 

cout « "Its area 1s " « ls->area() « ".\n"; 

return 0; 

1 

// End of File 



rectangle *cr = new rectangle(*r); 

But consider what happens if rectangle and triangle (and any 
other polygons) are derived from an abstract base class polygon 
derived from shape, rather than directly from shape, as outlined in 
Listing 3. (An abstract base class is a class with at least one pure 
virtual function. An abstract base class can be a derived class.) 

To satisfy the ARM, all the clone functions in Listing 3 return 
a shape *. (The declaration of polygon's clone function is inside a 
comment because you don't really need it. A function declared 
pure virtual in a base class remains pure virtual in the derived 
class unless overridden with an impure declaration.) When you 
clone a polygon, you get a pointer of type shape *, even though 
you know that pointer specifically addresses a polygon. Thus, you 
cannot clone a polygon and copy the result to a polygon * without 
a cast. That is, you cannot omit the cast in 
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All of the casts in the previous examples cast pointers to base 
class objects into pointers to derived class objects. These casts are 
commonly called "downcasts" because most people draw class hi- 
erarchies with the base classes above their derived classes. Re- 
member, when a class D is publicly derived from B, a D is a B, so 
you can safely convert a D * to a B * without a cast. But a B * is 
not necessarily a D * so you can't convert a B * downward to a D 
* without a cast. Thus, like all other casts, downcasts are generally 
unsafe unless you're absolutely, positively sure that your B * actu- 
ally points to a D. 

But the downcast in 

polygon *cp = (polygon *)p->clone(); 

is actually quite safe because we do know that p->clone() returns 
a polygon *. In fact, there's a whole family of similarly safe 
downcasts that occur commonly in object-oriented systems. The 
problem is that, on the surface, the safe casts look just like the 
unsafe ones. The cure is to augment the rules for virtual overrid- 
ing so that you can write the safe conversions without casts. 

For example, you should be able to declare each virtual clone 
function in a hierarchy so that it returns a pointer whose static 
type is the same as its dynamic type. That is, circle: :clone 



a cast. For instance, given 
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Listing 3 The shape hierarchy with rectangle and 
triangle derived from a bstract base class polygon 

class shape 
{ 

public: 

virtual shape *clone() const = 0; 

};' 



class circle : public shape 

{ 

public: 

shape *clone() const; 

};' 

shape *circle::clone() const 

{ 

return new circle(*this); 

} 



class polygon : public shape 
{ 

public: 

// shape *clone() const = 0; // still pure 



class rectangle : public polygon 

{ 

public: 

shape *clone() const; 

}•' 

shape *rectangle: :clone() const 

{ 

return new rectangl e(*this) ; 

} 



class triangle : public polygon 

{ 

public: 

shape *clone() const; 



); 



shape *tri angle: :clone() const 
{ 

return new triangle(*this) ; 

} 



// End of File 
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shape *s; 
circle *c; 

you can write 

shape *cs = s->clone(); 

to clone a shape, and 

circle *cc = c->clone(); 

to clone a circle. 

In a sense, declaring circle: :clone to 
return a circle * doesn't introduce any 
new conversions. It merely shifts the exact 
point where the conversions occur, or 
eliminates the conversions altogether. For 
example, when you write circle: -.clone as 

shape *circle::clone() const 

{ 

return new circle(*this); 
} 

a conversion from circle * to shape * 
occurs as part of the return statement. 
Then there's no conversion at all in a call- 
ing expression like 

shape *s; 

shape *cs = s->clone(); 

In contrast, when you write cir- 
cle: :cl one as 

circle *circle: :clone() const 
{ 

return new circle(*this) ; 
} 

no conversion occurs inside the function, but an 
implicit conversion from circle *(or rectan- 
gle *or triangle *) to shape * occurs in the 
calling expression. The net effect is the same. 

The New, Relaxed Rules 

The C++ standards committee agreed 
that the ARM's requirement on the return 
type of virtual functions is a bit too restric- 
tive. Thus, the current draft of the Work- 
ing Paper (the standard-to-be) relaxes the 
original rule. The new rule as it appears in 
the Working Paper is jargon-rich and 
seems to change with each new draft, so 
m spare you the exact words. Here's 
more-or-less what it says: 



For all classes B and D defined as 

class B 
{ 

virtual BT f(); 
}; 

class D : public B 

{ 
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#include <stdio.h> 



class X 
{ 

public: 

int *px; 

X( int init ) 

{ px = new int; *px = init; } 
~X( ) { delete px; } 

}; 

void print ( X x ) 

{ printft "%d\n", *x.px ) ; } 

int main() { 

X x(15) ; print ( x ) ; 

X y(16); print ( x ) ; print ( y ); 

return 0; 

} 

The output the programmer expected to see was 15, 15, and 16. Instead, he got 
15, 16, and 16. What went wrong'.' Call if you need a hint. Refer to Bug #1733. 
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OT f(); 
}; 

types BT and DT must be identical, or they must satisfy either of 
the following conditions: 

1. BT is BB *and DT is DD * where DD is derived from BB. 

2. BT is BB & and OF is DD & where DD is derived from BB. 
In either case (1) or (2), 

3. class D must have the access rights to convert a BB * (or BB 8) 
to a DD * (or DD &, respectively). 

In most common applications, BB is a public base class of DD, 
so D can perform the conversions. But, for example, if BB is a 
private base class of DD then the conversions are not valid, and BT 
and Or will not satisfy condition (3). 

The above rules apply even if D is derived indirectly from B. 
Or, BB might be B and DD might be D, The latter, in fact, is the case 
with clone functions. 

Listing 4 shows the shape hierarchy of Listing 1 rewritten us- 
ing the new relaxed rules for the return type of virtual functions. 
For completeness, I've included all the member function bodies so 
you can use them to build and execute the test code in Listing 2. 

Although the committee adopted these relaxed rules in March, 
1992, I believe most vendors have yet to release a C++ compiler 
that supports them. As of early 1994, only two of the six PC- 
based compilers I own (Borland 4.0 and Watcom 9.5) can compile 
Listing 4 without error. 
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cv-qualifiers in Return Types 

According to the current (September 1993) Working Paper, the 
cv-qualifiers (const and volatile) in the return types of the over- 
riding and overridden functions need not be identical. My under- 
standing is that the overriding function's return type cannot have 



Listing 4 The shape class hierarchy with virtual 
cloning functions employing the relaxed return type rules 





^include <iostream.h> 
^include <math.h> 
^include <stddef.h> 

// 

// base class 'shape' 
// 

class shape 
{ 

public: 

enum palette { BLUE, GREEN, RED ); 
shapetpalette c); 
virtual double areaO const = 0; 
virtual shape *clone() const ■ 0; 
palette colorO const; 
virtual const char *name() const « 0; 
virtual ostream &put(ostream &os) const; 
private: 

palette _color; 

static const char *colorJmage[RED - BLUE + 1]; 

}; 

const char *shape: :color_image[shape: : RED - shape: :BLUE + 1] = 
{ "blue", "green", "red" }; 

shape: :shape(palette c) : _color(c) { ) 

ostream Jshape: :put(ostream &os) const 

{ 

return os « color_1mage[color()] « 
} 

shape: :palette shape: :color() const 
{ 

return _color; 
1 



« nameO; 



// 

// class 'circle' derived from 'shape' 
// 

const double pi = 3.1415926; 

class circle : public shape 
{ 

public: 

circle(palette c, double r); 
double areaO const; 
circle *clone() const; 
const char *name() const; 
ostream iputtostream &os) const; 
private: 

double radius; 
}; 

circle::c1rcle(palette c, double r) : shape(c), radius(r) { ) 

double circle::area() const 
{ 

return pi * radius * radius; 
} 
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const char *circle: :name() const 

{ 

return "circle"; 
} 

ostream &circle::put(ostream &os) const 
{ 

return shape: :put(os) « " with radius = " « radius; 
} 

circle *circle::clone() const 
{ 

return new circle(*this); 
} 

// 

// class "rectangle' derived from 'shape' 
// 

class rectangle : public shape 

{ 

public; 

rectangletpalette c, double h, double w); 
double areaO const; 
rectangle *clone() const; 
const char *name() const; 
ostream &put(ostream &os) const; 
private: 

double height, width; 
): 

rectangle: :rectangle(palette c, double h, double w) 
: shape(c), height(h), width(w) { } 

double rectangle: :area() const 
{ 

return height * width; 

} 

const char *rectangle::name() const 
{ 

return "rectangle"; 
} 

ostream &rectangle: :put(ostream &os) const 

{ 

return shape: :put(os) « " with height = " « height 
« " and width = " « width; 

} 

rectangle *rectangle: :clone() const 

{ 

return new rectangle(*this); 
} 

// 

// class 'triangle' derived from 'shape' 
// 

class triangle : public shape 
{ 

public: 

triangletpalette c, double si, double s2, double a); 
double areaO const; 
triangle *clone() const; 
const char *name() const; 
ostream &put(ostream &os) const; 
private: 

double sidel, side2, angle; 
}; 

triangle: :triangle(palette c, double si, double s2, double a) 



: shape(c), sidel(sl), side2(s2), angle(a) { } 

double triangle::area() const 
{ 

return sidel * sin(angle) * side2 / 2; 
}; 

const char *triangle: :name() const 

{ 

return "triangle"; 
} 

ostream itriangle: :put(ostream &os) const 

{ 

return shape: :put(os) « " with one side = " « sidel 
« ", another side = " « side2 
« " and angle = " « angle; 

} 

triangle *triangle: :clone() const 
{ 

return new triangle(*this); 

} 

ostream &operator«(ostream &os, const shape &s) 

{ 

return s.put(os); 
} 

// End of File 
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any cv-qualifiers that are not also in the overridden function's re- 
turn type. Listing 5 shows some examples. 

Class B in Listing 5 declares virtual function f with a return 
type const BB * but class D overrides it with a function that re- 
turns DD * (where DD is publicly derived from BB). Hence, if bp is 
a B *that actually points to a D, then 

const BB *bbp = bp->f(); 

invokes D: : f applied to *b. D:: f returns a pointer to a non-const DD 
object, which the expression bp->f() quietly converts to const BB *. 

Pointer conversions that add cv-qualifiers are always safe, but 
conversions that strip off cv-qualifers are not. Thus, given 

char *cp; 

const char *ccp; 

then 

ccp = cp; 
is safe, but 
cp = ccp; 

is not. Similarly, as you convert derived types to their base types, 
adding cv-qualifiers to pointer types should not make the conver- 
sions any less safe. 
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Listing 5 also shows that derived class D has a virtual function 
g returning a const DD & that overrides a function returning a 
const volatile BB &. This is also valid. However, if you omit 
volatile from the return type of B::g, then D::f is erroneous. 

None of the compilers I own support this feature yet. 

More to Come 

Over the past two years, the standards cornmittee has added 
several other new features to C++: 

• run-time type identification 

• mutable members for const objects 

• namespaces 

• a predefined boolean type 

• new syntax for casts 

I will explain them all in upcoming columns. 

Meeting Dates, Etc. 

WG21+X3J16 will meet three times in 1994: 

• March 6-1 1 in San Diego, CA USA 

• July 10-15 in Waterloo, Ontario Canada 

• November 6-11 in Valley Forge, PA USA 

If all goes as scheduled, the draft standard should be available for 
public review and comment shortly after the July meeting. 

If you would like to participate in the standards process as a 
member of X3J16, contact the vice-chair: 

Jos6e Lajoie 

IBM Canada Laboratory 

844 Don Mills Rd. 

North York, Ontario M3C 1V7 Canada 

(416)448-2734 

josee&vnet. ibm.com 
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Listing 5 A derived class whose virtual functions 
have fewer cv-qualifiers than the functions they override 



class B 
{ 

virtual const BB *f(); 

virtual const volatile BB ig(); 

)!' 

class D : public B 
{ 

DD *f(); 
const DD &g(); 

h 

II End of File 



❖ Request 227 on Reader Service Card ❖ 



Page 1 00 



The C Users Journal — March 1 994 



~huck Allison 



The Preprocessor 



To use C effectively you really have to master two languages: 
the C language proper and the preprocessor. Before a compiler 
begins the usual chores of syntax checking and instruction transla- 
tion, it submits your program to a preliminary phase called pre- 
processing, which alters the very text of the program according to 
your instructions. The altered text that the compiler sees is called a 
translation unit. In particular, the preprocessor performs the fol- 
lowing three functions for you: 

1) header/source file inclusion 



\BC4\INCLU0E 

\MSVC\INCLUDE 

\WATC0M\H 



/* Borland C++ 4.0 */ 
/* Microsoft Visual C++ 
/* Watcom C/C++ */ 



2) macro expansion 

3) conditional compilation 

In this article I will illustrate these 
features of the preprocessor. 

The Include Directive 

One of the first source lines any C 
programmer sees or composes is this: 

^include <stdio.h> 



Code 
Capsules 



9> 



o 
Cr 

to 



Take a moment right now and jot down 
everything you know about this state- 
ment. 

Let's see how you did. stdio.h is of 
course a standard library header, so 
called because such include directives 
usually appear near the beginning of a 
source file so that their definitions will 
be in force throughout the rest of the 
compilation. We commonly think of it as 
a header file, but there is no requirement 
that the definitions and declarations per- 
taining to standard input and output re- 
side in a file. The C Standard only requires that these definitions 
and declarations replace the include directive in the text of the 
program before translation. They could reside in tables internal to 
the preprocessor. Most compiler implementations do supply 
header files for the standard library, however. MS-DOS compilers 
install header files in a suitable subdirectory. Here is a sampling: 




On UNIX systems you will find header files in /usr/include. 

Since an implementation is not even obliged to supply headers 
in the form of physical files, it's no surprise that those implemen- 
tations providing files don't always give them the same name as 
the include directive. After all, how 
could a compiler supply a file named 
stdio.h on a platform whose file system 
didn't allow periods in a file name? On 
MS-DOS systems there can be no file 
that exactly matches the C++ header 
<strstream.h>, because the file system 
only allows up to eight characters before 
the period. 

Most MS-DOS implementations map 
header names into file names by truncating 
the base part (the portion before the period) 
to eight characters, and the extension to 
three (so the definitions for <strstream.h> 
reside in the file STRSTREA.h). A standard- 
conforming implementation must supply a 
mapping to the local file system for user- 
defined header names having at least six 
characters before the period and one char- 
acter after. 

Conforming compilers also support 
include directives with string-like argu- 
ments, as in: 

include "mydefs.h" 

The string must represent a name recognized by the local file 
system. The file must be a valid C/C++- source file and, like the 
standard headers, usually contains function prototypes, macro defini- 
tions, and other declarations. An implementation must specify the 
mechanism it uses to locate the requested source file. On plat- 
forms with hierarchical file systems, the compiler usually searches 
the current directory first. If that fails, it then searches the subdirectory 
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reserved for the standard headers. Because standard header names 
are special preprocessing tokens and not strings, any backslashes 
in a header name are not interpreted as escape characters. In the 
following directive, a double backslash is not needed. 




#include 


Includes text of header or source file. 


#def ine 
#undef 


Enters a symbol into the symbol table for the 
current compilation unit, with an optional 
value. 

Removes a symbol from the symbol table. 


mi 

#elif 
#else 
#endif 


Control flow directives for conditional 
compi I at ion. 


#ifdef 
#ifndef 


Symbol table query directives. 

(Also used for conditional compilation). 


#line 


Renumbers the current source line. Utilities 
like code generators use this to synchronize 
generated lines with original source lines in 
error messages. 


#pragma 


Compi I er- dependent actions. 



#i Delude <sys\stat.h> /* \. not \\ */ 

#incl ude "\project\i ncl ude\mydef s . h" 

Included files may themselves contain other include directives, 
nested up to eight levels deep. Since some 
definitions (like typedefs) must only ap- 
pear once during a compilation, you must 
guard against the possibility of a file being 
included more than once. The customary 
technique defines a symbol associated with 
the file. Exclude the text of the file from 
the compilation if the symbol has already 
been seen by the compiler, as in the fol- 
lowing: 



/* mydefs.h */ 
#ifndef MYDEFS_H 
#define MYDEFSJ 



<declarations/definitions go here> 
#endif 

Macros 

As you can see, there's more to the 
//include directive than meets the eye. C 
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— John Moran 



Only 

$29.95 

($39.95 with disk) 



Identify Source Code ZOLC1 to Order W34 for the book or W36 for book with disk. 
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To Order Call 913-841-1631 FAX 913-841-2624 




VISA 
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provides eleven other preprocessor directives you can use to alter 
your source text in meaningful ways (see Table 1). (All begin with 
the '#* character, which must be the first non-space character on 
its source line.) In this section I elaborate on one of the other 
directives, the //define directive, to introduce a very useful con- 
struct called a macro. 

The //define directive creates macro definitions. A macro is a 
name for a sequence of zero or more preprocessing tokens. (Valid 
preprocessing tokens include valid C language tokens such as 
identifiers, strings, numbers and operators; and any single charac- 
ter). For example, the line 

tfdefine MAXLINES 500 

associates the text 500 with the symbol MAXLINES. The preproces- 
sor keeps a table of all symbols created by the //define directive, 
along with the corresponding replacement text. Whenever the pre- 
processor encounters the token MAXLINES outside of a quoted string 
or comment, it replaces MAXLINES with the token 500. In later 
phases of compilation it appears as if you actually typed 500 in- 
stead of MAXLINES. It is important to remember that this operation 
consists of mere text replacement. No semantic analysis occurs 
during preprocessing. 

A macro without parameters, such as MAXLINES, is sometimes 
called an object-like macro because it defines a progTam constant 
that looks like an object. Because object-like macros are often 
constants, it is customary to type them in upper case as a hint to 
the reader. You can also define function-like macros with zero or 
more parameters, as in the following code fragment: 



avoid surprises with respect to the surrounding text. To see this, 
define abs() without enclosing parens, as in: 

#define abs(x) (x) >= ? (x) : (-x) 

Then dbs(a) - I expands to 

(a) >= ? (a) : -(a) - 1 



Table 2 Pre-defined macros 




Macro 



Value 



_L I NE_ 

_FILE_ 
_DATE_ 

_TIME_ 

STDC 



The number of the current source 
line (equal to one more than the 
number of newline characters read 
so far). 

The name of the source file. 

The date of translation, in the 
form "Mmm dd yyyy." 

The time of translation, in the 
form "hh:mm:ss". 

1, if the compilation is in 
"standard" mode. 



#define beepO 
#define abs(x) 
#define max(x,y) 



putc('\a',stderr) 

((x) >= ? (x) : Hx)» 

(((x) > (y)) ? (x) : (y)) 



There must be no whitespace between the macro name and the 
first left parenthesis. The expression 

abs(-4) 

expands to 

((-4) >= ? (4) : (-(4))) 

You should always parenthesize macro parameters (such as x) 
in the replacement text. This practice prevents surprises from un- 
expected precedence in complex expressions. For example, if you 
had used the following naive mathematical definition for absolute 
value: 

x >= ? x : -x 

then the expression abs(a - 1) would expand to 
a - 1 >= ? a - 1 : -a - 1 

which is incorrect when a - 1 < (it should be -(a - 1)). 

Even if you put parentheses around all arguments, you should 
usually parenthesize the entire replacement expression as well to 
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It is also dangerous to use expressions 
with side effects as macro arguments. For 
example, the macro call abs(i++) expands to 

(H++) >= ? (i++) : (-(i++))) 



I tillg dined 
macros 



/* sysmac.c: Print system macros */ 


tfinclude <stdio.h> 






mainO 






{ 






printfC DATE == 


*s\n" 


DATE ) ; 


printfC FILE == 


%s\n" 


FILE ); 


printfC LINE == 


Sd\n" 


LINE ); 


printfC TIME == 


%s\n" 


TIME ); 


printfC" STDC == 


%d\n" 


STDC ); 


return 0; 






} 






/* Output: 






DATE == Dec 18 1993 






FILE == sysmac.c 






LINE == 9 






TIME. « 19:05:86 






STDC == 1 






*/ 






/* End of File */ 







probably isn't what you had in mind. 

Pre-defined Macros 

Conforming implementations supply 
the five built-in object-like macros shown 
in Table 2. The last three macros remain 
constant during the compilation of a 

Listing 2 Illustrates an 
assertion failure 



I* fail.c */ 
^include <stdio.h> 
#include <assert.h> 

mainO 
{ 

int i = 8; 

assertCi > 8); 
return 0; 

} 

/* Sample Execution: 
C:>assert 

Assertion failed: i > 8, 

file assert. c. line 9 
Abnormal program termination 
*/ 

/* End of File */ 



leading underscore followed by either an 
uppercase letter or another underscore. 

You may not redefine any of these five 
macros with the ^define directive, nor re- 
move them with the /fundef directive. 
Most compilers support multiple modes, 
some of which are not standard-conform- 
ing. (To guarantee that the sample pro- 
gram in Listing 1 will run correctly under 
Borland C, for example, you need to run 
in "ANSI mode" via the "-A" command- 
line option.) 

Conforming compilers also provide a 
function-like macro, assert, which you 
can use to put diagnostics in programs. If 
its argument evaluates to zero, assert 
prints the argument along with source file 

name and line number (using FILE_ 

and LINE_) to the standard error device 

and aborts the program (see Listing 2). 
For more information on using the assert 
macro, see the Code Capsule "File Proc- 
essing, Part 2" in the June 1993 issue of 
CUJ. 

A compiler is allowed to provide 
macro versions for any functions in the 
standard library (getc and putc usually 
come as macros for efficiency). With the 
exception of a handful of required func- 
tion-like macros (assert, setjmp, va_arg, 
va_end, and va_start), an implementation 
must also supply true function versions for 
all functions in the standard library. A 
macro version of a library function in ef- 
fect hides its prototype from the compiler, 
so its arguments are not type-checked dur- 
ing translation. To force the true function 
to be called, remove the macro definition 
with the tfundef directive, as in 

#undef getc 

Alternatively, you can surround the 
function name in parentheses when you 
call it, as in: 

c = (getc)(stdin); 

There's no danger of this expression 
matching the macro definition since a left 
parenthesis does not immediately follow 
the function name. 
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Conditional Compilation 

You can selectively include or exclude 
segments of code with conditional direc- 
tives. For example, you can embed the fol- 
lowing excerpt in your code to accommo- 
date different syntaxes of the delete op- 
erator in earlier versions of C++: 

#if VERSION < 3 

delete [strlen(p) + 1] p; 

#else 

delete [] p; 
#endif 

Your compiler probably supplies a 
macro similar to VERSION (Borland C++ 
defines _BCPLUSPLUS_, Microsoft _MSCVER). 
The argument of an //if directive must 
evaluate to an integer constant, and obeys 
the usual C rule of non-zero means true, 
zero false. You cannot use casts or the 
sizeof operator in such expressions. 

C++ implementations also pre-define 

the macro cplusplus, which you can use 

to customize your code for mixed C/C++ 
environments. For example, if you want to 
link with existing C code in a C++ envi- 
ronment, you need to use the extern "C" 
linkage specification (which of course is 
not valid in a C environment). The follow- 
ing excerpt will do the right thing in either 
environment: 

#ifdef cplusplus 

extern "C" 

{ 

#endif 

<put C declarations here> 

#ifdef cplusplus 

#endif 

The //if directive is handy when you 
want to comment out long passages of 
code. You can't just wrap such sections in 
a single, enclosing comment because there 
are likely to be comments in the code it- 
self (right?), causing the outer comment to 
end prematurely. It is better to enclose the 
code in question in the body of an /fi f di- 
rective that always evaluates to zero: 

#if 

<put code to be ignored here> 
#endif 



Preprocessor Operators 

Sometimes you just want to know if a 
macro is defined, without using its value. 
For example, if you only support two 
compilers, you might have something like 
the following in your code: 

#1f defined _MSCVER 

<put Microsoft-specific statements here) 

#elif defined BCPLUSPLUS 

<put Borland-specific statements here> 
#else 



#error Compiler not supported. 
#endif 

defined is one of three preprocessor op- 
erators (see Table 3). The defined opera- 
tor evaluates to 1 if its argument is present 
in the symbol table, meaning that the 
macro was either defined by a previous 
//define directive or the compiler provided 
it as a built-in macro. The terror directive 
prints its argument as a diagnostic and 
halts the translator. 
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It isn't necessary to assign a value to a macro. For example, to 
insert debug trace code into your program, you can do the follow- 
ing: 



#if defined DEBUG 
fprintf(stderr,"x 
#endif 



%d\n".x); 



To define the DEBUG macro, just insert the following state- 
ment before the first use of the macro: 



printfC'i = Xd\n".1); 

There is no way to build quoted strings like this without the 
stringizing operator because the preprocessor ignores macros in- 
side quoted strings. 

The token-pasting operator, ffl, concatenates two tokens to- 
gether to form a single token. The call traceZ(l) in Listing 4 is 
translated into 

trace(xl.d) 



Mefine DEBUG 



Any space surrounding these two operators is ignored. 



The following equivalences are recognized by the preproces- 



sor: 

#1f defined X <==> 
#if ! defined X <==> 



flfdef X 
#i f ndef X 



Using the defined operator is more flexible than the equivalent 
directives on the right because you can combine multiple tests as a 
;le expression, as in: 



#if defined cplusplus && Idefined DEBUG 

The operator #, the "stringizing" operator, effectively encloses 
a macro argument in quotes. As the program in Listing 3 illus- 
trates, stringizing can be useful for debugging. The traced macro 
encloses its arguments in quotes so they become part of a printf 
format statement. For example, the expression traced, d) be- 
comes 

printfC'i" " = %" "d" "\n",i); 

and, after the compiler concatenates adjacent string literals it sees 
this: 



Implementing assert ( ) 

Implementing assert reveals an important fact about using 
macros. Since the action of assert depends on the result of a test, 
you might first try an if statement, as in: 

#define assert(cond) \ 

if (!(cond)) _assert(#cond FILE LINE ) 

where the function assert prints the message and halts the pro- 
gram. This implementation causes a problem, however, when as- 
sert finds itself within an / f statement, as in: 

if (x > 0) 

assert(x != y) 

else 

/* whatever */ 
because the preceding code expands into 
if (x > 0) 

if (ICS != y)) _assert("x != y","file.c",7); 

else 

/* whatever */ 



Listing 3 Illustrates the 
stringizing operator 



I* trace. c: Illustrate a trace * 
* macro for debugging */ 

#include <stdio.h> 

♦define trace(x, format) \ 

printf(#x " = r #format "\n".x) 

mainO 
{ 

int i ■ 1; 
float x = 2.U; 
char *s = "three"; 



trace(i ,d) 
trace(x.f ) 
trace(s.s) 
return 8; 



) 



/* Output: 
i = 1 

x = ZMWM 
s - three 
*/ 

/* End of File */ 



Listing 4 Illustrates the 
token-pasting operator 







/* trace2.c: Illustrate a trace * 
* macro for debugging */ 

♦include <stdio.h> 

♦define tracetx, format) \ 

printf (#x " = I" #format "\n",x) 
♦define trace2(i) tracefx ♦♦ i.d) 



main!) 
{ 



} 



int xl - 1. 
trace2(l); 
trace2(2); 
trace2(3); 
return 0; 



x2 = 2, x3 = 3; 



/* Output: 
xl = 1 
x2 = 2 
x3 = 3 
V 

/* End of File */ 



The indentation that results from ex- 
panding assert in place is misleading be- 
cause it's actually the second 7 f that inter- 
cepts the else. Rewriting the expanded 
code to represent the actual flow of control 
produces: 

if (x > 0) 

if (Ux != y)) 

_assert("x != y","file.c",7) 
else /* OOPS! New control flow! */ 
/* whatever */ 

The usual fix for nested if problems 
such as this is to use braces, as in: 

#define assert(cond) \ 
{if (!(cond)) _assert 

(#cond._FILE LINE ) } 
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but this code expands into 

if (x > 0) 

{if (!(x != y)) _assert 
("x != y","file.c".7)}; 

else 

/* whatever */ 

and the combination }; in the second line creates a null statement 
that completes the outer If, leaving a dangling e/se, which is a 
syntax error. A correct way to define assert is shown in Listing 5. 
(This simple version does not recognize the macro NDEBUG.) (List- 
ing 6 shows the implementation of the support function as- 

sertO). In general, when a macro must make a choice, it is good 
practice to write it as an expression and not as a statement. 

Macro Magic 

It's important to understand precisely what steps the preproces- 
sor follows to expand macros, otherwise you can be in for some 
mysterious surprises. For example, if you insert the following line 
near the beginning of Listing 4: 

Mefine xl SURPRISE! 

then trace2(l) expands into 

trace(x # l.d) 



Code Capsules 

which in turn becomes 
trace(xl.d) 

But the preprocessor doesn't stop there. It rescans the line to 
see if any other macros need expanding. The final state of the 
program text seen by the compiler is shown in Listing 7. 

To further illustrate, consider the text in Listing 8. Listing 8 is 
not a complete program, by the way, but is for preprocessing only 
— don't try to compile it all the way. (If you have Borland C use 
the CPP command.) The output from the preprocessor appears in 
Listing 9. The str() macro just puts quotes around its argument. 
It might appear that xstr() is redundant, but there is an important 
difference between XStrO and str( ). The output of the statement 
str(VERSION) is of course 



Table 3 Preprocessor operators 



Operator 


Usage 


# 


Stringizing 


## 


Token pasting 


def i ned 


Symbol table query 
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"VERSION" 

but xstr( VERSION) expands to 
str(2) 

because arguments not connected with a #or /ff/aie fully expanded 
before they replace their respective parameters. The preprocessor 
then rescans the statement, providing "2". So in effect, xstr() is a 
version of str() that expands its argument before quoting it. 

The same relationship exists between glueO and xglueO. The 
statement glue(VERSI0N,3) concatenates its arguments into the to- 
ken VERSI0N3, but xglue(VERSI0N,3) first expands VERSION, pro- 
ducing 

glue(2,3) 

which in turn rescans into the token 23. 

The next two statements are a little trickier: 

glue(VERSJON) 
== VERS » ION 
== VERSION 
== 2 

and 



xglue(VERSJON) 
== glue (VERSATILE) 
== VERS «# ATILE 
== VERSATILE 

Of course, if VERSATILE were a defined macro it would be further 
expanded. 

The last four statements in listing 8 expand as follows: 
ID(VERSION) 

== "This is version "xstr(2) 
== "This is version "str(2) 
== "This is version ""2" 

INCFILE(VERSION) 
== xstr(glue(version,2)) ".h" 
== xstr(version2) \h" 
== "version2" ".h" 

strUNCFILE(VERSION)) 
== #INCFILE(VERSION) 
== "INCFILE(VERSION)" 

xstr(INCFILE( VERSION)) 
== str("version2" ".h") 
== #"version2" ".h" 
== "\"version2\" \".h\"" 
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Listing 5 A simple implementation of the assert 



macro 



/* assert. h */ 

extern void assert(char *. char *, long); 

flundef assert 
#ifdef NDEBUG 
#define assert(cond) 

(void) 
#else 

#define assert(cond) \ 
((cond) \ 
? (void) \ 

: _assert(#cond FILE LINE ) ) 

/* End of File */ 



Listing 6 The _assert support function 



I* xassert.c */ 
#include <stdio.h> 
include <stdlib.h> 

void _assert(char *cond, char *fname, long lineno) 



{ 



fprintf (stderr, 

"Assertion failed: %s, file %s, line %ld\n" 
cond, fname, lineno); 

abortO ; 



/* End of File */ 
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For obvious reasons, the # operator effectively inserts escape char- 
acters before all embedded quotes and backslashes. 

The macro replacement facilities of the preprocessor clearly of- 
fer you an incredible amount of flexibility (too much, some would 
say). There are two limitations to keep in mind: 

1) If at any time the preprocessor encounters the current macro in 
its own replacement text, no matter how deeply nested in the 
process, the preprocessor does not expand it but leaves it as-is 
(otherwise the process would never terminate!). For example, 
given the definitions 

#define F(f) f(args) 
#define args a,b 
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vertical tab ( MO. and horizontal tab ( 'It')- 

Many non-U.S. environments use different graphics for some 
of the elements of the source character set, making it impossible 
to write readable C programs. To overcome this obstacle, standard 
C defines a number of trigraphs, which are triplets of characters 
from the Invariant Code Set (ISO 646-1983) found in virtually 
every environment in the world. Each trigraph corresponds to a 
character in the source character set which is not in ISO 646 (see 
Table 4). For example, whenever the preprocessor encounters the 
token ??= anywhere in your source text (even in strings), it replaces 
this token with the '#' character code from the source character set. 



F(g) expands to g(a,b), but what does 
F(F) expand to? (Answer: F(a,b)). 

2) If a fully-expanded statement resembles 
a preprocessor directive, (e.g., if expan- 
sion results in an //include directive), 
the directive is not invoked, but is left 
verbatim in the program text. (Thank 
goodness!). 

Character Sets and Trigraphs 

The character set you use to compose 
your program doesn't have to be the same 
as the one in which the program executes. 
These two character sets often differ in 
non-English applications. A C translator 
only understands the source character set 
— English alphanumerics, the graphics 
characters used for operators and punctua- 
tors (there are 29 of them), and a few con- 
trol characters (newline, horizontal tab, 
vertical tab, and form-feed). Any other 
characters presented to the translator may 
appear only in quoted strings, character 
constants, header names or comments. The 
execution character set is the set of char- 
acters that the program uses in its literals, 
and to input and output data. This set is 
implementation-defined, but must at least 
contain characters representing alert 
(MO, backspace ( '\b carriage return 
(MO, newline (MO, form feed (MO. 



Listing 7 Preprocessed source 
with a surprise 



mainO 
{ 

int SURPRISE! = 
printf("xl" " ■ 
printf("x2" " = 
printf("x3" " = 
return 8; 
) 

/* End of File 



1. x2 = 2. x3 = 3: 
J" "d" "\n",SURPRISE!) ; 
r "d" "\n\x2): 
r "d" "\n".x3); 



LANGUAGE 




-lint 



for C/C++ 

presents Bug # 1729 



#include <iostreaiti.h> 



class X 
{ 

public : 
int upper ; 
int lower; 
X(int init) 
{} 

}; 



lower (init), upper ( lower +1 ) 



X x(l), 



This programmer expected the value of lower and upper of object x to 
be initialized to I and 2 respectively; instead, both were given the same 
value (1). How come? Call if you need a hint. Refer to Bug #1729. 



PC-lint for C/C++ will catch this and many 
other bugs. It will analyze a mixed suite of C 
and C++ modules to uncover bugs, glitches, 
quirks and inconsistencies. 
Numerous C++ Warnings and Messages: 
Are your inherited destructors virtual? Are 
your constructor new's matched by your 
destructor delete's? Are your initializers 
in order? Are names inadvertently hiding 
other names? Are your C++ modules 
consistent with your C modules? Much, 
much, more. 

Plus Our Traditional C Warnings: 

Uninitialized variables, unaccessed variables, 
possibly uninitialized variables, strong type 
mismatches, indentation irregularities, loss of 
precision, strange uses of Booleans, 
signed/unsigned mismatches, suspicious 
expressions, unused macros, etc. etc. 



Full C++ Support - PC-lint for C/C++ 
is based on the ARM and is tracking the 
latest ANSI/ISO draft including exceptions 
and templates. It supports both Borland and 
Microsoft C/C++. 

Options Galore: A plethora of options for 
message suppression, message format, 
compiler dependencies, etc. All messages 
can be individually suppressed or enabled, 
both locally and globally. Numerous 
compilers/ libraries supported. Runs on 
MS-DOS (Optional built-in 386 DOS 
extender) and OS/2. 

PC-lint for C $139 
PC-lint for C/C++ $239 

PC-lint users: call for update pricing 
Unix and Mainframe programmers: 

call for pricing for FlexeLint. 



3207 Hogarth Lane, Collegeville, PA 19426 
CALL TODAY (215) 584-4261 Or FAX (215) 584-4266 

30 Day Money-back Guarantee. 
PA add 6% sales lax. PC-lint and FlexeLint are trademarks of Gimpel Software 
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The program in Listing 11 shows how to write the "Hello, world!" 
program from Listing 10 using trigraphs. (Borland users: you have 
a separate executable, trigraph.exe, forprocesing trigraphs.) 

In an effort to enable more readable programs world-wide, the 
C++ draft standard defines a set of digraphs and new keywords 
for non-ASCII developers (see Table 5). Listing 12 shows what 
"Hello, world" looks like using these new tokens, Perhaps you 
will agree that the symmetric look of the bracketing operators is 
easier on the eye. 

Phases Of Translation 

The C standard defines eight distinct phases of translation. An 
implementation doesn't make eight separate passes through the 
code, of course, but the result of translation must behave as if it 
had. The eight phases are: 

1. Physical source characters are mapped into the source character 
set. This includes trigraph replacement and things like mapping a 
carriage return/line feed to a single newline character in MS-DOS. 

2. All lines that end in a backslash are merged with their continu- 
ation line, and the backslash is deleted. 

3. The source is parsed into preprocessing tokens and comments 
are replaced with a single space character. The C++ digraphs 
are recognized as tokens. 

4. Preprocessing directives are invoked and macros are expanded. 
Steps 1 through 4 are repeated for any included files. 



Heap Management for Windows and DOS 



MoreHeap dos/$i79, dos & windows/$249 



• Same API for Windows or DOS • Virtual memory (VM) for DOS and all MS- 
Windows modes • Swaps to extended, expanded memory and disk • VM binary 
trees (keyed and sorted access), multigigabyte arrays, stacks, queues, and 
linked lists for any data types— C++ class and C function interface • LRU 
algorithm ensures fast access to VM data • Emulate MS-Windows memory 
management API under DOS • Direct, linktime replacement for malloc function 
family • Just relink and malloc/new allocates from UMB, HMA, and EMM frame 

• Heap dump to video, file, or debug monitor with a single function call • Solves 
MS-Windows selector limitation problem • Solves heap fragmentation problems 

• Detects memory leaks, doubly freed pointers, and buffer overwrites • Works 
with SafeWin Windows debugger for the ultimate MS — Windows debug system 

• Complete source code included 



SafeHeap 



• Link-time replacement for str* and mem* routines ■ Relink and run to 
detect buffer manipulation problems with globals, autos, and allocated blocks 

• Provides symbolic stack trace on error ■ Use with MoreHeap for enhanced 
debug capabilities • No memory overhead • Even debugs RTL and third party 
library function calls with no source code • Complete source code included 



MegaHeap 



• A single, file i/o tike interface to expanded/extended memory and disk • Auto- 
matically detects and uses resources • Just allocate a buffer and read and write 
to it like a file • Allocate up to 4GB • No block or transfer size limitations • Great 
for graphic images, large arrays, and more • Complete source code included 



C-Shell 



• Replacement function for exec and spawn • Shrinks to a resident 5K 
kernel and spawns second application • Spawn a 600K program from a 600K 
program! • Swaps to expanded/extended memory and disk • Complete 
source code included 



Call for demo disks. 

Visa/MasterCard/COD/ 
POs accepted. 30 day 
money-back guarantee. 

Bundles 

DOSPack (MoreHeap/DOS, 
SafeHeapMegaHeap, C-Shell) 
$299 

WindowsPack (MoreHeap/ 
DOS & Windows, SafeWin) 




Compatible with Borland C+ + 
and Microsoft C+ + . 

SeaBreeze Software Systems 

12Tomlyn Drive 
Princeton, NJ 08540 

Sales/Support: 609-924-6793 
BBS/FAX: 609497-4607 
e-mail/CIS: 72330, 705 



5. Escape sequences in character constants and string literals that 
represent characters in the execution set are converted (e.g., 
'la' would be converted to a byte value of 7 in an ASCII 
environment). 

6. Adjacent string literals are concatenated. 

7. Traditional compilation occurs: lexical and semantic analysis, 
and translation to assembly or machine code. 

8. Linking occurs: external references are resolved and a program 
image is made ready for execution. 

The preprocessor performs steps 1 through 4. 

C++ And The Preprocessor 

C++ preprocessing formally differs from that of C only in the 
tokens it recognizes. A C++ preprocessor must recognize the to- 
kens in Table 5 as well as . *, ->*, and ; ;. It must also recognize 
//-style comments and replace them with a single space. Though 







Listing 8 Illustrates macro rescanning 



I* preproc.c: Test ♦ and ## preprocessing operators 
* 

* NOTE: DO NOT COMPILE! Preprocess only! 



/* Handy stringizing macros */ 
♦define str(s) #s 
#define xstr(s) str(s) 

/* Handy token-pasting macors */ 
♦define glue(a.b) a#b 
♦define xglue(a.b) glue(a.b) 

/* Some definitions */ 

♦define ID(x) "This is version " ♦♦ xstr(x) 

♦define INCFILE(x) xstr(glue(version.x)) ".If 

♦define VERSION 2 

♦define ION ATILE 

/* Expand some macros */ 

str(VERSION) 

xstr(VERSION) 

glue(VERSI0N.3) 

xglue(VERSI0N,3) 

glue(VERS.ION) 

xglue(VERS.ION) 

/* Expand some more */ 
ID(VERSION) 
INCFILE(VERSION) 
str ( INCFILE(VERSION) ) 
xstrUNCFILE(VERSION)) 
/* End of File */ 



Listing 9 Preprocessed results from Listing 





"VERSION" 
"2" 

VERSI0N3 

23 

2 

VERSATILE 

"This is version ""2" 
"version2" ".h" 
"INCFILE(VERSION)" 
"VverslonZV V.hV" 
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C++'s preprocessor isn't much different than C's, you may want 
to use it a lot differently. For example, as far as I can tell, there is 
no good reason to define object-like macros anymore. You should 
use const variable definitions instead. The statement 

const int MAXLINES = 500; 



example, replace the max macro i 

inline int max(int x, int y) 
{ 

return x >= y ? x : y; 

} 



■ with 



has a couple of advantages over 
#define MAXLINES 500 

Since the compiler knows the semantics 
of the object, you get stronger compile- 
time type checking. You can also reference 
const objects like any other with a sym- 
bolic debugger. Global const objects have 
internal linkage unless you explicitly de- 
clare them extern, so you can safely re- 
place all your object-like macros with 
const definitions. 

Function-like macros are almost unnec- 
essary in C++. You can replace most func- 
tion-like macros with inline functions. For 



Table 4 Trigraph sequences 







Trigraph 


C Source Character 


??= 


# 


??( 


[ 


??/ 


\ 


??) 


] 


?? 1 




??< 


{ 


??! 


1 


??> 


> 


??- 







Table 5 New C++ digraphs 
and identifiers 





Token 


Translation 


<% 


( 


%> 


> 


<: 


[ 


:> 


] 


XX 


# 


bitand 


& 


and 


&& 


bitor 






or 




1 


xor 






compl 






and_eq 


&= 


or_eq 




= 


xor_eq 


. 




not 


! 


not_eq 


! 


= 



Note that you don't have to worry about parenthesizing to 
avoid precedence surprises, because this code defines a real func- 
tion, with scope and type checking. You also don't have to worry 
about side effects like you do with macros, such as in the call 



Energize Your DOS Applications 
with a Windows-Style Interface 



Are your DOS applications 
. starting to show signs of age? 
If so, it's time to do some remodeling. 
With our new C/Windows Toolchest™, 
you can easily create interfaces for 
your DOS applications 
that are similar to 
Microsoft* Windows™ 
applications. 

Two simple 
function calls are all 
it takes to create 
movable, resizable 
windows, complete 
with scroll bars and 
other standard 
controls; including 
minimize, maximize, 
restore, and menu buttons. A wide 
variety of other controls are also 
available; including push buttons, radio 
buttons, and check boxes. 

Of course there is extensive support 
for menus. Create horizontal and 
vertical menus, with or without scroll 
bars. Arrange menu items in a single 
row or column, or in multiple rows and 
columns. Attach a sub-menu to any 
menu item. 

For collecting user input, you get 
a comprehensive set of functions to 
manage data entry fields. Collect 
data one field at a time, or all at once 




through complete data entry forms. 
Use picture clauses to build data entry 
templates. Valid input may be enforced 
automatically, or you can define your 
own input validation functions. 

Handling mouse 
input is easy. There 
are numerous high 
level mouse 
functions, including 
one that retrieves 
all mouse events 
and keystrokes. 
Mouse input is 
handled auto- 
matically by control 
buttons, menus, 
and data entry 
fields. Low level mouse functions are 
also provided just in case you need 
them. 

In all, the C/Windows Toolchest™ 
contains more than 250 functions to 
help you design a state-of-the-art user 
interface. Included are functions for 
implementing context sensitive help, 
keyboard control and graphics. You 
also receive the complete source code 
for a multi-window Notepad editor that 
works in both text and graphics mode. 
C/Windows Toolchest™ works with C 
and C++ compilers from Mix*. Borland", 
and Microsoft 1 . 



Now One Interface Library Lets You Create 



□ Please send FREE brochures □ C/windows Toolchest $39.95 
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(Source code for C/Windows library ) 
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To Order Please Call: 

1-800-333-0330 

Orders or Technical Questions: 
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Tel: 1-214-783-6001 
Fax: 1-214-783-1404 



Mix Software 

1 132 Commerce Dr. 

Richardson, 

TX 75081 
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Code Capsules 



max(x++,y++) 

The macro version may seem superior to the inline function 
because it accepts arguments of any type. No problem. Define max 
as a template, as in the following code; now the inline function 
will accept arguments of any type: 

tempi ate<cl ass T> 

inline int max(const T& x, const T& y) 
{ 



return x > y ? x : y; 



} 



Listing 10 -\ "Hello, world!" program 



I* hello. c: Greet either the user or the world */ 
//include <stdio.h> 

maindnt argc, char *argv[]) 
{ 

if (argc > 1 && argv[l] != NULL) 
printfC'Hello, %s!\n".argv[l]); 

else 

printfC'Hello, world!\n"); 
return 0; 

} 

/* End of File */ 



Listing 11 "Hello, World!" using trigraphs 



I* thello.c: Greeting program using trigraphs */ 
^include <stdio.h> 

maindnt argc, char *argv??(??)) 
??< 

if (argc > 1 && argv??(0??) != NULL) 
printfC'Hello, %s!??/n",argv??(l??)); 

else 

printfC'Hello, world!??/n"); 
return 8; 

??> 

/* End of File */ 



Listing 1 2 "Hello, World!" with the new C++ digraphs 
and tokens 



I* dhello.c: Greeting program using C++ digraphs */ 
//include <stdio.h> 

maindnt argc, char *argv<::>) 
<% 

if (argc > 1 and argv<:0:> != NULL) 
printfC'Hello, %s!??/n".argv<:l:>); 

else 

printfC'Hello, world!??/n") ; 
return 0; 

%> 

I* End of File */ 



Do keep in mind, however, that inline is a only hint to the 
compiler. Not all functions are amenable to inlining, especially 
those with loops and complicated control structures. Your com- 
piler may tell you that it can't inline a function. Still, in many 
cases it is better to define a function out-of-line than to define it as 
a macro and lose the type safety that a real function affords. 

There is still room in C++ for function-like macros that use the 
stringizing or token-pasting operators. The program in Listing 13 
uses stringizing and an inline function to test the new string class 
available with Borland C++ 4.0. 

Conclusion 

The preprocessor doesn't know C or C++. It is a language all 
its own. Many library vendors have used the preprocessor intelli- 
gently to simplify the installation and use of their products. I en- 
courage you to use it, but to use it prudently. It has some dark 
corners, which I've purposely avoided. It is good practice, espe- 
cially with C++, to do as much as you can in the programming 
e, and use the preprocessor only when you need to. □ 
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// tstr.cpp: Test the C++ string class 

♦include <iostream.h> 
♦include <stddef.h> 
♦include <cstring.h> 

// Handy display macros 
♦define result(exp) \ 

cout « ♦exp ": \"" « (exp) « 'V « endl 
♦define test(obj.exp) \ 

exp. pr1nt(#obj ", after " fexp ":\rf\obj) 

// Print a string in quotes 

inline void printtconst char *p. const string& s) 

{ 

cout « p « « s « « endl; 

} 

mainO 
{ 

string slC'Now is the time for all worthy carbon units"), 
s2 = "to come to the aid of their sector.", 
s3 = '\n', 
s4(sl); 

size_t len = sl.lengthO; 



// Test some operators 
resulttsl == s4); 
resulttsl < s4); 
resulttsl + s3 + s2); 
testtsl.sl += s3 + s2); 
resulttsl == s4): 
testtsl.sl.resizetlen)); 
resulttsl == s4); 
cout « endl ; 

// Search and replace 
size_t pos = sl.f1nd("alD; 
if (pos ! = NPOS) 

test(sl,sl.replace(pos,3,"some")); 
pos = sl.findC'worthy"); 
if (pos != NPOS) 
{ 

resulttsl. substr(pos, 5)); 
test(sl,sl.insert(pos,"un")); 

} 

cout « endl ; 
// More searching 

resulttsl. f1nd_f1 rst_of("aeiou")) ; 
result(sl.find_fi rst_not_of("aeiou")); 
resulttsl. find_last_of("ae1ou")); 
resul t ( si . f i ndj ast_not_of ("aei ou") ) ; 
cout « endl ; 
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) 



// Subscripting 
pos = s2.find_f1rst_of('d'); 
test(s2,s2[pos] = '1 '); 
return ; 



/* Output: 
si == s4: "1" 
si < s4: "0" 

si + s3 + s2: "Now is the time for all worthy carbon units 

to come to the aid of their sector." 

si, after si += s3 + s2: 

"Now is the time for all worthy carbon units 

to come to the aid of their sector." 

si == s4: "0" 

si, after sl.resize(len): 

"Now is the time for all worthy carbon units" 

si == s4: "1" 

si, after sl.replace(pos,3,"some"): 

"Now is the time for some worthy carbon units" 

sl.substr(pos,5): "worth" 

si, after sl.insert(pos,"un") : 

"Now 1s the time for some unworthy carbon units" 

sl.find_first_of("ae1ou"): "1" 
sl.find_first_not_of("aeiou") : "0" 
si . f i ndj ast_of ( "ae1 ou" ) : "43" 
sl.find_last_not_of("ae1ou"): "45" 

s2, after s2[pos] = T: 

"to come to the ail of their sector." 



// End of File 
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C Elements of Style 



reviewed by Dwayne Phillips 



Steve Oualline' s C Elements of Style is, as its name suggests, a 
style manual for C programming. Qualline outlines a method for 
writing clear and decipherable C code. He emphasizes a simple 
and straightforward style. In his words, this book is for program- 
mers "who want their programs to be easily read and maintained 
by others." 

Audience 

You do not need to be a C wizard to understand this book. In 
fact, wizards who write statements like: 

*desti nati on++ = *source++ 

may not like this book. Oualline advocates the more accessible: 

♦destination = *source; destination++; source++; 

If you write programs that must be corrected or augmented by 
others, this book will be of interest to you. It is especially appro- 
priate for relatively new programmers who are struggling to learn 
good C programming habits. 

Contents 

C Elements of Style has nine chapters, a compact style manual, 
two appendices, and an index. The chapters cover the topics ex- 
pected in this type of book. They include (1) style and program 
organization, (2) file basics, comments, and program headings, (3) 
variable names, (4) statement formatting, (5) statement details, (6) 
the preprocessor, (7) C++ style, (8) directory organization and 
makefile style, and (9) user-friendly programming. 



For much of the book, Oualline gives examples of good and bad 
code, and summarizes with style rules. His rules are simple and easy 
to apply. Some of the rules apply to the process of writing code. For 
example, "Comment your code as you write it." (This rule, he says, 
saves time in the long run.) Other rules address the code itself: "Con- 
stant names are all upper case" and "Follow every variable declara- 
tion with a comment that defines it." Some rules just make a pro- 
grammer's life easier: "Assume that *, /, and % come before + and -. 
Put parentheses around everything else." 

The style rules are aimed at making programs readable and 
reliable. Good variable and subroutine names, which help make 
the code explain itself, and good comments, which help reveal the 
organization of programs, enhance readability. Oualline strives to 
increase reliability by limiting the code to safe subsets of the C 
language. (Not allowing shortcuts such as *destination++ = 
*source++ reduces the risk of problematic side effects.) Oualline 
describes this emphasis on readable and reliable code as "defen- 
sive programming" or "doing a lot of thinking so I don't have to 
do a lot of thinking." 

The chapter on makefile style is outstanding and to my knowl- 
edge unique. Makefiles are essential to C programming and are 
often the hardest part of a project to understand. Other books de- 
scribe how to use makefiles, but this is the only book I have seen 
that tells how to organize and format them. Oualline formally de- 
fines many makefile items that have become pseudo standards 
over the years. This material may seem trivial to an experienced 
UNIX C programmer, but many C programmers today have never 
worked on a UNIX system (believe it or not). 

The chapter on user-friendly programming is a bit out of place, 
but useful. It discusses how to write programs that users will actu- 
ally use. (It includes the Law of Least Astonishment: The program 
should act in a way that least astonishes the user.) 



Dwayne Phillips works as a computer and electronics engineer with the U.S. Department of Defense. He has a PhD in Electrical and 
Computer Engineering from Louisiana State University. His interests include computer vision, artificial intelligence, software engineering, 
and programming languages. 
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Book Review 



Dwayne Phillips 



The style manual is 35 pages of rules without all the discus- 
sion. For those short on time, this book-within-a-book provides a 
concise summary of the text. 

The first appendix shows three complete code examples (two 
in C, one in C++) that employ the style rules given in the body of 
the book. These examples show Oualline's recommendations in 
practice. The second appendix lists all the rules given in the chap- 
ters. (Take these seven pages and pin them on the wall next to the 
coffee machine.) 

Other Style Manuals 

For years, the only programming style manual available was 
Kernighan and Plauger's thin little classic The Elements of Pro- 
gramming Style [1]. Fortunately, several style manuals have ap- 
peared in the recent past — each written with a different point of 
view. 

Plum's C Programming Guidelines [2] and C++ Programming 
Guidelines [3] (reviewed in The C Users Journal, January 1993) are 
comprehensive references on programming standards and style. They 
are written in a compact, subroutine-like style that is appropriate for 
reference books. These books are technical and not for the novice. 

Steve McConnel's Code Complete [4] is a comprehensive 
handbook for programmers. As such, it includes plenty of good 
advice on programming style, but its style sections are scattered 
throughout the 800-plus pages. 

While Oualline favors code that anyone can understand, Ranade 
and Nash's The Elements of C Programming Style [5] (reviewed 



in The C Users Journal, July 1993) encourages programmers to 
master and exploit the notation of the C language. (Ranade and 
Nash's do recommend backing away from terse C style if the audi- 
ence includes programmers who have a limited knowledge of C.) 

Conclusion 

Oualline's book is the closest to Kernighan and Plauger's and 
it serves as a worthy update to that earlier classic. It is a short, yet 
complete treatment of C style. 

C Elements of Style is a deserving addition to the desk top — 
not just the bookshelf. □ 
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Victor R. Volkman 



IOCCC, ASXXXX, MINED, TDE Update, 

and a Bug Fix 



CUG Library Volume IV 

CUG Library proudly announces volume IV of its directory of 
user-supported C source code. This latest effort thoroughly cata- 
logs CUG Library volume numbers #300 through #349. Volume 
IV includes both exhaustive reviews of selected volumes plus cap- 
sule summaries of all volumes. In all, 
this amounts to more than 250 cross-ref- 
erenced and indexed pages of informa- 
tion. Volume IV can be yours for $10 or 
order the set of volumes I through IV for 
just $28 total. As always, see the order 
blank in the center portion of this issue. 

Bug Fix for GNUPlot, 
CUG #334 

Arild Olsen <d_olsen_o@kari .uio.no> 
writes: 

"I just received the disk, and the HPUII- 
driver does not function, as stated by R.T. 
Stevens in his review (CUJ, June 93). Maybe 
this is due to an incompatibility between 
HP LaserJet II and HI; I have a LJ HI. 
When sending a bitmap to the printer, 
the program specifies TIFF-format. This 
is not correct since the bitmap is plain. 

To solve this, edit the HPLJIItext 
function in the HPLJIJ driver. The string 
"\033*b2m%dU" should be changed to 
"\033*b@m%dU". 



• Thomson-Davis Editor (CUG #386 update): 
text/binary file editor — new version 3.2A 



multi-window 



New Acquisitions 
and Updates 




This month we present three additions to the CUG Library, as 
well as an update to a recently featured volume. 

• International Obfuscated C Code Contest (CUG #397) 

• ASxxxx Cross Assembler - Part 3 (CUG #398): MC 68HC08 
CPU support 

• MINED Editor: (CUG #399) 



International Obfuscated C Code Contest 
1984-1993: CUG #397 

Landon Noll (Sunnyvale, CA) submits 
a decade of source code from the Inter- 
national Obfuscated C Code Contest 
(IOCCC). This contest has long been a 
favorite of many CUJ readers. The en- 
tire IOCCC archive from 1984-1993 is 
now available as a two-diskette set from 
the CUG Library. Obfuscation implies 
purposefully obscuring and confusing a 
situation. Why obfuscate C code? The of- 
ficial IOCCC states its objectives as fol- 
lows: 

• To show the importance of program- 
ming style, in an ironic way. 

• To stress C compilers by feeding 
them unusual code. 

• To illustrate some of the subtleties of 
the C language. 

• To provide a safe forum for poor C 
code. 

Recently, Bob van der Poel reviewed 
Don Libes' book entitled Obfuscated C 
and Other Mysteries (see CUJ, October 
1993, pp. 131-132). The diskette for this 
book includes IOCCC entries from 
1984-1991. Libes has produced special 
reports about the IOCCC several times 
in CUJ. Please see the following back issues for more detail: 

Libes, Don. "Don't Put This on Your Resume," CUJ, May 
1991, p. 89. 

Libes, Don. "The Far Side of C," CUJ, May 1990, p. 125. 

Libes, Don. "The International Obfuscated C Code Contest," 
CUJ, July 1989, p. 93. 

The CUG Library volume #397 contains the full IOCCC archive 
including two additional years not included in the Libes' book. 



Victor R. Volkman received a BS in Computer Science from Michigan Technological University. He has been a frequent contributor to 
The C Users Journal since 1987. He is currently employed as Senior Analyst at H.C.I.A. of Ann Arbor, Michigan. He can be reached by 
dial-in at the HAL 9000 BBS (313) 663-4173 or by Usenet mail to sysop@hal 9k. con. 
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CUG New Releases 

In addition to dozens and dozens of obfuscated C programs, 
the archive includes complete rules and guidelines so you can sub- 
mit your own entries into next year's contest. Some of the obfus- 
cated programs are quite useful, including scaled-down versions of 
make, grep, and various editors. 

ASxxxx Cross Assembler - Part 3: CUG 398 

Cross assemblers continue to play an important role in the 
CUG Library. A cross assembler reads assembly language source 
code for a non-native CPU and writes object code that can be 
linked and downloaded to the target machine for execution. Em- 
bedded systems developers are the most frequent users of cross 
assemblers. This month, Alan R. Baldwin (Kent State University, 
Ohio), adds his third cross assembler to the CUG Library's repe- 
toire. ASxxxx Part 3 provides a complete Motorola 68HC08 de- 
velopment system. ASxxxx Part 3 version 1.50 (released 8/9/93) is 
immediately available as CUG volume #398. 

The CUG distribution of ASxxx Part 3 includes MS-DOS ex- 
ecutables for the ASxxxx Cross Assembler and Linker. However, 
if you want to recompile the Cross Assembler or Linker, you'll 
also need ASxxxx Part 1 (CUG #292). ASxxx Part 2 contains 
cross assembler source files for the 6816 CPU. The ASxxxx fam- 
ily of cross assemblers can be built on DEC machines running 
DECUS C in the TSX+ environment or PDOS C v5.4b under RT- 
11. ASxxxx has been built with Borland C++ v3.1 under MS-DOS 
and includes a project (.PRJ) file. Although only these implemen- 
tations have been specifically tested, Baldwin claims many other 
K&R C compilers may work as well. 

ASxxxx Part 3 includes a comprehensive 80-page manual cov- 
ering functionality provided by all three existing ASxxxx cross 
assemblers and linkers. The documentation lays out the exact 
specifications of syntax for symbols, labels, assembler directives, 
and expressions in detail. The manual includes appendices with 
instruction set highlights and supported syntax for Motorola 6800, 
6801, 6804, 6805, 68HC08, 6809, 6811 6816, Intel 8080 and 
8085, and Zilog Z80 and HD64180 CPUs. 



Table 1 Regular Expression operator precedence: 
(based on the table in Dr. Aho's book! 



Victor Volkman 

The ASxxxx assembler falls short of full macro implementation, but 
does include a host of important features such as: if/then/else, //include 
files, radix support from binary to hexadecimal, and a full complement of 
C-language operators for expressions. The ASxxxx linker goes beyond 
conventional loaders by resolving intermodule symbols, combining code 
into segments, relocating absolute symbols and base addresses, and pro- 
ducing either Intel HEX or Motorola S19 output files. 

MINED Editor: CUG #399 

MINED, by Thomas Wolff (Freie Universitat Berlin, Institut fur 
Informatik, Germany), is a modeless full-screen text editor. MINED 
was originally written for MINK and now works with most UNIX 
platforms as well as MS-DOS, and DEC VAX-11/VMS. MINED 
works best at editing small files (50K or less) and can edit many files 
simultaneously. Unlike other editors which have separate command 
modes and input modes, MINED uses a modeless design for ease of 
use. It also includes powerful regular expression operations for both 
searching and replacing text. MINED Version 3 (released 08/04/93) is 
immediately available as CUG volume #399. 

Thompson-Davis Editor Update: CUG #386 

The Thomson-Davis Editor, as provided by Frank Davis (Tifton, 
GA), is a multi-file/multi- window binary and text file editor written 
for IBM PCs and close compatibles. Thomson-Davis Editor (TDE) 
works well with batch files, binary files, text files, and various com- 
puter language source code files. TDE can handle any size of file and 
any number of windows that fit in conventional DOS memory. 

Davis reports the following enhancements since TDE was last 
released to the CUG Library: 

• Pop-up pull-down command menu = <CTRL>+\ 

• More Language support, thanks to Byrial Jensen, <byria l&Sa inri . aau. dk> 

• TDE ported to Linux (POSK, SVR4, BSD4.3+?, FTPS 151-1, etc.) 

• A bug (a blunder, actually) got fixed in the 3.1 config utility. 

• Linux FAQs and HOWTOs 

• New regular expression meta characters: < = Empty string at 
beginning of word; > = Empty string at end of word 

Non-English Language Support 

Byrial Jensen contributed several functions to TDE that are useful 
with non-English languages. Using these functions, DOS filenames 
can contain extended ASCII characters. As a result, the dirlist func- 
tion in TDE (which sorts filenames according to the sort order 
array) can be customized to your favorite alphabet. Byrial also 
contributed two new macro functions that look at the Caps Lock 
key: IfCapsLock and IfNotCapLock. Other changes supporting non- 
English usage are as follows: predefined regular expression mac- 
ros may be redefined; all editor prompts have been gathered into 
prompts. h; response letters have been gathered into letters. 1% and 
the window letters can be changed to follow a non-English alphabet. 

Improved Regular Expression Handling 

Davis writes: "I use the regular expression search much more 
often than I first anticipated. A couple of features missing in the 
original implementation are the beginning-of-word and end-of- 
word metacharacters. These metacharacters really come in handy 
for culling prefixes and suffixes from the search. Here's our new 
regular expression table: [Please refer to Table 1]" 

TDE version 3.2a (Released 11/15/93) immediately replaces 
version 3.0 and is available as CUG Library volume #386. □ 



char 



x = string r,s = regular expression 
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\c 
\:c 
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[x] 

fx] 

r* 

r+ 

r? 

rs 

r | s 

(r) 



any non-operator character 

c literally and C escapes 

predefined macro: 

\:a - alphanumeric 
\:b - white space 
\:c - alphabetic 
\:d - decimal 
\:h - hex 
\: I - lower alpha 
\:u - upper alpha 

any character but newline 

beginning of word 

end of word 

beginning of line 

end of line 

any character in x 

any character not in x 

zero or more r's 

one or more r 1 s 

zero or one r 

r fol lowed by s 

either r or s 
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kitty | cat 
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Introduction 

This month's product focus is derived from documentation 
written by M.C. Little and D.L. McCue. Little and McCue have 
provided this documentation, which describes their C++ SIM 
simulation class library, expressly for re- 
print in The C Users Journal, 

C++ SIM is a class library which 
provides discrete process-based simula- 
tion similar to that provided by SIMULA 
[Birtwhistle 73][Dahl 70] and has been 
used in the work presented in [McCue 
92]. Based on the facilities provided in 
SIMULA, C++ SIM provides active ob- 
jects (instances of C++ classes) as the 
units of simulation using the type-inheri- 
tance facilities of C++ to convey the no- 
tion of "activity." 

C++ SIM is designed to be used with 
a user-supplied threads package. C++ 
SIM's authors use Sun Microsystem's 
lightweight process (thread) package; 
however, they have added this package 
to the simulation class hierarchy through 
an abstract class definition so that other 
lightweight process packages can be 
used instead with very little modifica- 
tion. Users of this framework can replace 
existing classes as long as the replace- 
ments conform [Black 86] to the original 
class definition. 

This article describes the C++ SIM 
class hierarchy, and shows how it can be used to further refine the 
simulation package [1]. 

The Class Hierarchy 

Figure 2 illustrates the main class hierarchy within the simula- 
tion package. The base class is Thread, which provides the mini- 
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mum functionality required of a threads library. Two classes, GNU- 
Thread and LUP_Thread, derive from the Thread class to support 
the threads packages that were available to C++ SIM's authors at 
the time of this writing. These classes are Sun's own lightweight 
process package, and the GNU threads library. Class ThreadJType 
provides a (relatively) transparent way to 
change from one thread implementation 
to another. Class Process provides all 
operations required by the simulator to 
control execution of all processes in the 
simulation. These classes are described 
in the following sections. 



The Threads Base Class 

In keeping with the C++ program- 
ming model, classes obtain the thread 
characteristic, necessary to convey the 
notion of "activity" within the simula- 
tion environment, by inheriting an ap- 
propriate base class (in simulation terms 
they become processes). In C++ SIM, all 
classes that provide the abstraction of 
threads must be derived from the Thread 
base class. This base class forces the de- 
rived class to provide a minimum set of 
operations required for the management 
of threads. (The base class defines these 
operations as pure virtual functions, and 
C++ requires that a deriving class define 
such functions before an instance of the 
class can be declared.) These operations 




are shown in the Thread class as follows: 



class Thread 
{ 

public: 

virtual void SuspendO 
virtual void ResumeO : 



0; // pure virtual function 
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virtual long IdentityO; 
static Thread* SelfO; 

}; 

When defined, the Suspend and Resume methods will give the 
thread package specific ways of suspending and resuming execu- 
tion of a thread respectively. 

Body represents the controlling code for each object, i.e., the 
scope within which the controlling thread will execute. 

Current_Thredd must be defined by the derived class, since it 
returns the identity of the currently executing thread, which is spe- 
cific to the thread package used. 

The base class itself implements the operations Identity and 
Se 1 f because some threads packages do not provide similar func- 
tionality. Identity returns the unique identity of the thread associ- 
ated with a given object, and Self returns the currently executing 
thread. Because Self is a static member function programs can 
invoke it without creating an instance of the Thread class, i.e., 
programs may call Thread: :Self(). 

The Class LWP_Thread 

User classes which require separate threads of control using the 
Sun thread package can be derived from the LUP_Thread class 
shown as follows: 

class LWP_Thread : public Thread 
{ 

public: 

virtual void SuspendO; 
virtual void ResumeO; 
virtual void BodyO = 0; 

virtual long CurrentJThreadO; 

thread_t ThreadJDO; 
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protected: 

static const int MaxPriority; 
LWP_Thread(int priority = MaxPriority); 

}; 

The MaxPriority constant represents the maximum priority at 
which a thread may execute (by default all threads derived from 
this class execute at this priority). Class LUP_Thread defines all of 
the pure virtual functions declared in Thread except Body, which 
must be defined by the deriving class. 

Initialize initializes the threads package prior to use. (Obvi- 
ously the operations performed within this method are thread 
package specific.) 

Thread_ID returns more detailed (package-specific) information 
about the associated thread. 

The Process Class 

Applications could derive from the Thread base class to pro- 
vide active objects in C++ outside of the simulation package. 
However, to become a process in the simulation environment, a 
class must be derived from the Process base class. 

This class is shown as follows: 

class Process : public LWP_Thread 

{ 

public: 

virtual -Process (); 

static double CurrentTime (); 

void ActivateBefore (Process&); 

void ActivateAfter (Process&); 

void ActivateAt (double AtTime = CurrentTimeO); 

void ActivateDelay (double AtTime = CurrentTimeO); 

void ActivateO; 

void ReActivateBefore (Process!!); 



■ - , ■ ■ : 
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void ReActivateAfter (Process&); 

void ReActivateAt (double AtTime = CurrentTimeO) ; 

void ReActivateDelay (double AtTime = CurrentTimeO); 

void ReActivate 0; 

void Cancel 0; 

double evtime (); 

void set_evtime (double); 

boolean idle 0; 
boolean terminated 0; 

virtual void Body = 0; 



evtime returns the simulation time at which a process is due to 
be reactivated; set_evtime enables a program to change this time. 

The Hold method removes the active process from the head of 
the event queue and schedules it to become active a specified 
number of time units later. 

Passivate removes the currently active process from the event 
queue altogether. If the process is to execute again the program 
must recreate it. 

Cancel removes the process from the simulation queue or sim- 
ply suspends it indefinitely if it is currently not in the queue. 

At any point in time, a process can be in one (and only one) of 
the following states: 



protected: 

Process 0; 



void Hold (double t); 
void Passivate 0; 



idle returns either TRUE or FALSE 
depending upon whether the process is 
currently in the simulation queue. 

terminated returns either TRUE or 
FALSE depending upon whether the proc- 
ess is terminated. 
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• active: the process is at the head of the queue maintained by 
the scheduler (to be described shortly) and its actions are being 
executed. 

• suspended: the process is in the queue maintained by the 
scheduler, scheduled to become active at a specified time in the 
future. 

• passive: the process is not in the scheduler's queue. Unless an- 
other process brings it back into the queue, it will not execute 
any further. 

• terminated: the process is not in the scheduler's queue and has 
no further actions to execute. 

There are five ways to activate a process, and similarly five 
ways to reactivate a waiting process: 

• before another process (ActivateBefore and ReActivateBe- 
fore); 

• after another process (Activate After and ReActivateAfter); 

• at a specified (simulated) time (ActivateAt and ReActivateAt); 

• after a specified (simulated) delay (ActivateDelay and ReActi- 
vateDelay); 

• activate now (at the current simulated time) (Activate and Re- 
Activate). 

(Note that if a process is already scheduled, reactivation will sim- 
ply re-schedule the process.) 

The CurrentTime method returns the current simulation time; 
programs typically call CurrentTime to control action relative to a 
given time period. 

The Simulation Scheduler 

As in SIMULA, simulation processes (entities) execute at their 
assigned simulation time, which ; s typically determined by an ap- 
propriate distribution function. Only one process executes in any 
instance of real time, but many processes may execute at any in- 
stance of simulation time. Programs place currently inactive proc- 
esses in a simulation queue (the event queue), which is arranged 
in order of increasing simulation time. 

To coordinate the execution of these processes, the scheduler 
manages the simulation queue as follows: when no process is cur- 
rently active, the scheduler selects a process to run from the head 
of the queue and (re-) activates it. When no processes are left to 
execute, i.e., the queue is empty, the simulation ends. 

The simulation queue is organized as a tree to improve the 
efficiency of the scheduling algorithm. All nodes (processes) at 
the same level of the tree are assigned to the same simulation 
time, as shown in Figure 1. 

Because the scheduler manages processes in the simulation en- 
vironment it cannot itself be a simulation process. Like the main 
thread to be described later, the scheduler is a priority thread 
within the environment and as such must be controlled in a 
slightly different manner than the other simulation entities. The 
structure of the scheduler is extremely simple and is shown as 
follows: 

class Scheduler : public LWP_Thread 

{ 

public: 

Scheduler (); 
-Scheduler (); 
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void Body 0; 

double CurrentTime 0; 



}; 



Every simulation application must start one scheduler before the 
simulation can begin. The example to be described near the end of 
this article illustrates use of the scheduler. 

Priority Threads 

C++ SIM executes two "priority" threads which cannot be de- 
rived from the Process base class and therefore must be activated 
and deactivated separately. These threads are as follows: 

• the simulation scheduler: this thread must be activated via the 
Resume method of the thread base class from which it is de- 
rived (e.g., LUP_Thread); 

• the thread associated with main. A program must suspend this 
thread to allow other threads to run since this thread has the 
highest priority in the system. Calling the Thread class In- 
itialize method within the main body of the simulation code 
adds this thread to the thread queue maintained by class 
Thread. The thread's presence in the queue allows the Suspend 
method to act on it when the program requirs it to become 
inactive (using the Thread: :Self()->Suspend() operation). 

Distribution Functions 

Simulations often require distribution functions of various 
events (e.g., the rate of arrivals of jobs at a processor, or the time 
between failures for a node). C++ SIM provides a set of classes 
which give access to various useful distribution functions, includ- 
ing the following: RandomStream, UniformStream, Draw, Exponen- 
tialStream, ErlangStream, HyperExponential Stream, and Normal- 
Stream. By creating instances of these classes the simulation proc- 
esses can gain access to the appropriate distribution function. Fig- 
ure 3 shows the class hierarchy of the distribution functions. 

RandomStream and Norma 1 Stream 

Classes RandomStream and Norma 1 Stream illustrate how the dis- 
tribution functions are derived and show how further functions 



Figure 3 ffass hierarchy for distribution func.tions 
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could be built. RandomStream (from which all other distribution 
functions are derived) is shown as follows: 

class RandomStream 

{ 

public: 

RandomStream (long MGSeed = 772531L, 

long LCGSeed = 1878892440L); 
virtual double operatorO = 0; 
double Error (); 

protected: 

double Uniform (); 

private: 

double MGen 0; 
double series[128]; 
long MSeed, LSeed; 

1: 

The Error method returns a chi-square error measure on the 
uniform distribution function. The Uniform method generates ran- 
dom numbers; Uniform uses the linear congruential generator 
based on the algorithm from [Knuth Vol2], and shuffles the results 
of the linear generator with the multiplicative generator as sug- 
gested by [Knuth Vol2] [3] to obtain a sufficiently uniform ran- 
dom distribution. 
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class Normal Stream : public RandomStream 
{ 

public: 

NormalStream (double Mean, double StandardDeviation) ; 
virtual double operatorO 0; 

private: 

double Mean. StandardDeviation; 
double z; 

}; 

The operatorO uses the polar method in [Knuth Vol2] [4] to 
implement the Normal St ream by making use of the Uniform 
method of RandomStream. 

SIMSET 

C++ SIM also provides entity and set manipulation facilities 
similar to those provided by the SIMSET classes of SIMULA. 
These facilities break down into two classes: 

• Link: the Link class provides elements of a doubly linked list; 

• Head: the Head class maintains doubly linked lists of Link ele- 
ments. 

Class link is defined as follows: 



{ 

public: 

virtual -Link (); 

Link* Sue () const; 
Link* Pred () const; 

Link* Out 0; 
void InTo (Head*); 

void Precede (Link*); 

void Precede (Head*); 

void Follow (Link*); 

void Follow (Head*); 

protected: 
Link (); 

}; 

Because it makes no sense to create instances of Link objects, 
the constructor for Link is protected — programs must derive a 
class from Link to benefit from its functionality. 
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Sue and Pred return the successor and predecessor of this list 
element respectively. These functions return if no such element 
exists. 

Out removes the object to which it currently belongs (if any) 
from the linked list. InTo makes this object the last element in a 
linked list if the list exists; If the list doesn't exist Out attempts to 
remove the object from any linked list to which it may belong. 

Precede also places an object in a linked list. If Precede is 
passed another Link element, say L, then if L is a member of a 
linked list, this object is placed into the same linked list and im- 
mediately preceding L If L isn't a member of a linked list, the 
result is the same as for Out. If Precede is passed a Head object it 
produces the same result as InTo. 

Follow acts similarly to Precede, except that L.Follow(Ll) in- 
serts L immediately after LI, and L.Follow(H), places L as the first 
element in H, where H is a Head object. 

Note that as in SIMULA, Link elements can only belong to 
one linked list at a time. 

Class Head is defined as follows: 

class Head 
{ 

public: 

Head 0; 

virtual -Head (); 

Link* First () const; 
Link* Last () const; 

long Cardinal const; 
boolean Empty () const; 

void Clear (); 

}; 

First and Last return references to the first and last Link ob- 
jects in the list respectively. If the list is empty then these func- 
tions return 0. 

Cardinal returns the number of Link objects in the list, and 
Empty returns TRUE if the list is empty, FALSE otherwise. Clear 
removes all Link objects from the list. 

Example: Job Service Simulation 

This example is taken from [Mitrani 82] and simulates a proc- 
ess scheduler for a machine which attempts to execute as many 
process (jobs) as possible. The machine can only process one job 
at a time and queues job requests until it can deal with them. The 
machine is prone to failures, so started jobs will be interrupted by 
such failures and delayed until the machine has been repaired (re- 
activated), at which point it is forced to restart execution from the 
beginning (i.e., it is placed at the head of the job queue). The main 
processes within this example are: 

• Arrivals: this process controls the rate at which jobs arrive at 
the service (Machine). 

• Breaks: this process controls the availability of the Machine by 
"killing" it and restarting it at intervals drawn from a Uniform 
distribution. 



• Job: this process represents the jobs that the Machine must 
process. 

• Machine: this is the machine on which the service resides. Ma- 
chine obtains Jobs from the job queue for the service and then 
attempts to execute them. The machine can fail and so the re- 
sponse time for Jobs is not guaranteed to be the same every 
time the job is performed. 

Arrivals 

The Arrivals class definition is relatively simple since none of 
the other processes invoke operations on it. Arrivals is defined as 
follows: 

class Arrivals : public Process 
{ 

public: 

Arrivals (double); 
-Arrivals (); 

void Body (); 

private: 

Exponential Stream* InterArrivalTime; 

}; 
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April 

18- 21 ISCA '94: 21st International Symposium on Computer 
Architecture. Chicago, DL. Sponsored by ACM special interest 
group ARCH and the IEEE-TC CA. Contact Wen-mei Hwu, 
Coordinated Science Laboratory, 1308 W. Main Street, Ur- 
bana, IL 61801. (217)-244-8270. e-mail: hwu@crhc.uiuc.edu. 

19- 21 Embedded Systems Conference East. Boston, MA. Con- 
tact Amy Royer, Embedded Systems Conference, 600 Harri- 
son St., San Francisco, CA 94107. (415)-905-8198. 

24- 28 CHI '94: ACM Conference on Human Factors in Com- 
puter Systems. Boston, MA. Sponsored by ACM special inter- 
est group CHI. Contact Thomas Hewett, Drexel University, 
Dept. of Psych/Soc/Anthro, Central Receiving, 33rd & Lud- 
low Streets, Philadelphia, PA 19104. (215)-590-8616, 8672. 
e-mail: hewett.chiixerox.com. 

May 

17-20 CoopIS-94:Second International Conference on Coopera- 
tive Information Systems. Formerly "Intelligent & Cooperative In- 
formation Systems (ICICIS)." Toronto, Canada. Contact John 
Mylopolous, (416)-978-5180. e-mail: coopis@cs.toronto.edu. 

23-25 Symposium on Theory of Computing. Montreal, Canada, 
Sponsored by ACM special interest group ACT. Contact 
Pierre McKenzie, Dept. IRO, Universite de Montreal, CP. 
6128 succursale A Montreal, Quebec H3C 3J7 CANADA. 
(513)-343-6176. e-mail: mckenzie@iro.umontreal.ca. 

June 

9-11 The Grace Hopper Celebration of Women in Computing. 
Washington, D.C. Sponsored by ACM and CRA, the Comput- 
ing Research Association. Contact Anita Borg, Digital Equip- 
ment Corp., 250 University Ave., Palo Alto, CA 94301. (415)- 
688-1367. e-mail: borg@pa.dec.com. 

25- 26 5th International Workshop on ML and its Applications. 
Orlando, FL. Sponsored by ACM special interest group 
PLAN. Contact John Reppy, AT&T Bell Laboratories, 600 
Mountain Avenue, Rm. 2A-428, Murray Hill, NJ 07974. 
(908)-5 82-4084. e-mail: jhr@research.att.com. 

26- 29 6th Annual ACM Symposium on Parallel Algorithms 
and Architectures. Cape May, NJ. Sponsored by ACM special 
interest groups ACT and ARCH. Contact Satish Rao, NEC 
Research Institute, 4 Independence Way, Princeton, NJ 08540. 
(609)-951-2714. e-mail: satish@research.nj.nec.com. 



The constructor initializes the stream from which the rate of 
Job arrivals is drawn and the destructor simply cleans up before 
the object is destroyed: 

Arrivals: :Arrivals (double mean) 
{ 

InterArrivalTime = new Exponential Stream(mean); 

} 

Arrivals: :~Arrivals () { delete InterArrivalTime; } 

The main body of Arrivals (shown below) simply waits for an 
amount of time dictated by the rate of arrivals stream and then 
creates another Job. This procedure is repeated until the simulation 
ends. 

void Arrivals: :Body () 

{ 

for (;;) // ini finite loop 

{ 

Hold((*InterAmvalTime)()); 
Job* work = new Job(); 

} 

} 



job 

Unlike Arrivals, which is an active entity within the simula- 
tion, the Job class does not need to be a separate process, since it 
is simply enqueued when it is created and dequeued by the Ma- 
chine when it can be executed. All a given Job must do is calcu- 
late how long it took to be "processed": 

class Job 
{ 

public: 

Job 0; 
-Job (); 

private: 

double Arrival Time; 
double ResponseTime; 

}; 

Because no operations are invoked on instances of the Job 
class, its constructor and destructor perform all of its work: 

Job:: Job () 
{ 

boolean empty; 

ResponseTime = 0; 

ArrivalTime = sc->CurrentTime(); 

empty = JobQ.IsEmptyO; 

JobQ.Enqueue(this); // place this Job on to the queue 
Total Jobs++; 

if (empty && !M->Processing() && M->IsOperational()) 
M->ActivateO; // Machine idle as no Jobs in queue 
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// and not broken 



} 



boolean working; 



}; 



Job::~Job 
{ 

ResponseTime = sc->CurrentTime() - ArrivalTime; 
Total ResponseTi me += ResponseTime; 

} 



As with the Breaks and Arrivals processes, Machine's con- 
structor and destructor initialize and delete the stream that dictates 
the time required to process a Job. 

Processing returns the current status of the machine, i.e., 
whether or not it is executing a job: 



Queue 

The program places jobs which are not being serviced in a job 
queue. As with the Job class, an instance of Queue is not required 
to be active, and as such Queue is not derived from the Process 
class. 

Queue is defined as follows: 



boolean Machine-Processing () { return working; } 

Broken and Fixed de-activate (crash) and re-activate the ma- 
chine respectively: 

void Machine:: Broken { operational = false; } 
void Machine: :Fixed () { operational = true; } 



class Queue 
{ 

public: 

Queue (); 
-Queue 0; 

boolean Is Empty 0; 

// returns TRUE if no Jobs in queue 

long QueueSize (); 

// returns number of Jobs in queue 

Job* DeQueue (); 

// returns head of queue 

void Enqueue (Job*); 

// places Job at tail of queue 

}; 



Machine 

The Machine process obtains Jobs from the queue and proc- 
esses them. Since Machine is prone to failures Jobs can take ex- 
tended periods of time to complete. Other simulation processes 
invoke various operations on the machine (for example to deter- 
mine whether or not it has failed): 

class Machine : public Process 
{ 

public: 

Machine (double); 
-Machine (); 

void Body (); 

void Broken (); 
void Fixed (); 
boolean IsOperational 0; 
boolean Processing (); 
double ServiceTime (); 

private: 

Exponential Stream* STime; 
boolean operational; 



IsOperational indicates whether or not the machine is cur- 
rently active (i.e., whether it has "crashed"): 

boolean Machine: : IsOperational { return operational; } 

ServiceTime returns the time required to service a given job 
based on the relevant distribution function initialized within the 
constructor: 
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double Machine: :ServiceTime { return (*STime)(); } 



} 

} 



Victor Volkman 



The main body of the Machine gets a Job from the job queue 
(if one is available) and attempts to process it before looping 
again: 

void Machine: :Body () 
{ 

for (;;) 
{ 

working = true; 

while (UobQ.IsEmptyO) 

// continue as long as Jobs are available 

{ 

Hold(ServiceTimeO); 
Job* J = JobQ.DequeueO; 

ProcessedJobs++; 

// keep track of number of completed Jobs 
delete J; // remove finished Job 

} 



Breaks 

The Breaks class defines a process which simply waits for a 
specific period of time before "killing" the Machine process. This 
process then waits again before re-activating the machine. The 
Breaks class definition is relatively simple: 

class Breaks : public Process 
{ 

public: 

Breaks (); 
-Breaks (); 

void Body (); 

private: 

UniformStream* RepairTime; 
UniformStream* OperativeTime; 
boolean interrupted_service; 

}; 



working = false; 

// no Jobs in queue so become idle 
Cancel (); 
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The constructor and destructor simply initialize and delete the 
streams used by the Breaks process respectively. 

The main body of the Breaks process activates and deactivates 
the Machine process. The Machine fails and recovers according to 
the OperativeTime and RepairTime distribution functions respec- 
tively. The body is defined as follows: 



extern Machine* M; 
extern Queue JobQ; 



// This is the machine used to 
// service requests 
// This is the queue from which 
// Jobs are drawn 
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void Breaks:: Body 
{ 

for (;;) 
{ 

Hold((*OperativeTime)0); 
M->Broken(); 

// de-activate the Machine 
M->Cancel(); 

// remove Machine from Scheduler queue 

if (UobQ.IsEmptyO) 

interrupted_service = true; 

Hold((*RepairTime)0); 

M->Fixed(); // re-activate the Machine 

if (interrupted_service) 

{ 

interrupted_service = false; 
M->ActivateAt(M->ServiceTime() + 
CurrentTimeO); 

} 

else 
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M->ActivateAt(); 

} 

} 

MachineShop 

The MachineShop class is the core of the simulation; it starts 
up all of the main processes involved, and when the simulation 
ends it prints out the results. 

class MachineShop : public Process 
{ 

public: 

MachineShop (); 
-MachineShop (); 

void Body (); 
void Await 0; 

}; 

The Body method starts up the other processes, such as the Ma - 
chine, and then waits until the number of processed Jobs is at 
least 100,000: 

void MachineShop: : Body 
{ 

sc = new Scheduler! ); // create the simulation 

// queue scheduler 
Arrivals* A = new Arri vals(10) ; 
M = new Machine(8); 
Job* J = new Job; 
Breaks* B = new Breaks; 

// activate the relevant simulation processes 

B->Activate(); 
A->Activate(); 

sc->Resume(); // start up the scheduler 

// - it is not a process 

while (ProcessedJobs < 100000) 
Hold (10000); 

cout « "Total number of jobs processed " 
« Total Jobs « endl; 

cout « "Total response time " « Total ResponseTi me « endl; 

cout « "Avge response " « 

(Total ResponseTime/ProcessedJobs) « endl; 

cout « "Avge number jobs present " 

« (JobsInQueue/CheckFreq) « endl; 

// end simulation by suspending processes 



C++ SIM 

It isn't necessary to explicitly activate the Machine process because 
the Breaks or Jobs process will do this. 

The Await method suspends the thread associated with main, 
thus allowing the other simulation threads to execute: 

void MachineShop: :Await() 

{ 

ResumeO; 

Thread: :Self()->Suspend(); 

} 



Main 

The main part of the simulation code initializes the various 
thread- specific variables used (e.g., the maximum priority of a 
thread), creates the main body of the simulation code (in this case 
MachineShop) and then suspends the thread associated with main: 

void main () 
{ 

LWP_Thread::Initialize(); 
MachineShop m; 

m.AwaitO; // Suspend main's thread 

// (NOTE: this MUST be done 
// by all applications). 
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sc->Suspend(); 

A->Suspend(); 

B->Suspend(); 



The C Users Journal 



— March 1994 



❖ Request 318 on Reader Service Card ❖ 



Page 129 



C++ SIM 



Victor Volkman 



number generators) with little effect on the overall system 
structure. 



Conclusions 

The authors of C++ SIM have endeavoured to provide a simu- 
lation package which provides similar functionality to that of 
SIMULA, since SIMULA has fulfilled the needs of users over 
many years. From their experiences of using SIMULA, both as a 
general programming language and as a simulation tool, they be- 
lieve they have been successful. As a result of using C++ they 
also believe that they have produced a simulation package having 
several advantages over SIMULA, for example: 

• performance — C++ compilers typically generate code that is 
several times more efficient than similar SIMULA code, and as 
a result, simulations execute correspondingly faster; 

• C++ provides more extensive object-oriented features than 
SIMULA, allowing, for example, class instance variables to be 
either publicly or only privately available. In SIMULA, every- 
thing is public, affecting the way code is written and providing 
extra problems during debugging. 

• C++ SIM incorporates inheritance throughout its design to an 
even a greater extent than is already provided in SIMULA. For 
example, C++ SIM's I/O facilities, random number generators, 
and probability distribution functions are entirely object-ori- 
ented, relying on inheritance to specialize their behavior. 
Hence, users can add new functionality (e.g., new random 




MEMORY • Under 35K non- 
discardable memory per instance. 

^Pi^Mr J TIME * Loacls in a fraction of tne 

j^E^r^/l time needed by other editors. 

^y\^^ MOVEMENT • Nearly all sophisticated features 
■PI available from either the keyboard or the mouse. 

^j^^ MEMORIZATION • SpexEdit uses the same robust set 

of editing primitives as the Unix Vi editor which are combined 

to form editing phrases. Other editors have a cumbersome set of prepackaged 
functions. SpexEdit delivers an editing language to be used on the fly. 

MONEY • SpexEdit is the most-affordable 

re professional Windows 
editor for programmers. 



r\y^ fuii " featur 

Edit Files Up to ^ ^LJB 

2 Million Lines • I ines lln tn 




2 Million Lines • Lines Up to 
2K Bytes • MDI Interface • Multiple 
Instances • Regular Expressions • 27 Cut/Copy 
Buffers • 9 Ripple Delete Buffers • Single-Stroke Undo/Redo • Mark 
& Jump • Block Shifts • Auto Indent • Delimiter Matching • Status 
Bar* On-Line Reference • Pop-Up Manipulator Menu • Selectable 
Fonts • Variable Tabs • Full Session Memory • Drag and Drop 



StiPicFdit PR0FESSI0NAL ( 

/ , f# WINDOWS EDITOR ■ 

CALL FOR FREE DEMO DISK! 



REQUIRES WINDOWS 3.1 




Little Wing 

4618 J.F.K. BOULEVARD, SUITE 176 
NORTH LITTLE ROCK, ARKANSAS 72116 
CALL (501) 771-2408 9AM-5PM (Central) 



Acknowledgements 



The authors would like to thank Professor Isi Mitrani for the 
help he has given them in the development of this simulation 
package and the time he has devoted to listening to their thoughts 
and problems. They would also like to thank Ron Kerr for his 
help with the SIMULA language, and Dr. Graham Parrington for 
his comments on drafts of this article. The work reported here has 
been supported by SERC/MOD Grant GR/H81078 and Esprit 
Broadcast (Basic Research Project Number 6360). □ 

References 

[Birtwhistle 73] G. M. Birtwhistle, 0-J. Dahl, B. Myhrhaug, K. 
Nygaard, Simula Begin, Academic Press, 1973. 

[Black 86] A. Black et al, "Object Structure in the Emerald 
System", Proceedings of the ACM Conference on Object-Oriented 
Programming Systems, Languages, and Applications, October 
1986. 

[Dahl 70] O-J. Dahl, B. Myhrhaug, K. Nygaard, "SIMULA 
Common Base Language," Technical Report S-22, Norwegian 
Computing Centre, 1970. 

[Knuth Vol2] Knuth Vol2, Seminumerical Algorithms, Ad- 
dison-Wesley: p. 1 17. 

[McCue 92] D. L. McCue and M. C. Little, "Computing Rep- 
lica Placement in Distributed Systems," Proceedings of the 2nd 
Workshop on the Management of Replicated Data, November 
1992: pp. 58-61. 

[Mitrani 82] I. Mitrani, Simulation Techniques for Discrete Event 
Systems, Cambridge University Press, Cambridge, 1982: p. 22. 

[Sedgewick 83] R. Sedgewick, Algorithms, Addison-Wesley, 
Reading MA, 1983: pp. 36-38. 

[Stroustrup 86] B. Stroustrup, The C++ Programming Lan- 
guage, Addison Wesley: 1986. 

Footnotes 
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Y[i] * 5 A 5 mod 2 A 26, where the period is 2 A 24, and the initial 
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[3] As suggested by Maclaren and Marsaglia. 
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Blue Sky Releases 

Code Generator for OWL v2.0 

Blue Sky Software Corporation has re- 
leased WindowsMAKER Professional v5, a 
Prototyper and C/C++ code generator for 
Windows and Windows NT, which lets Bor- 
land C++ v4.0 users generate OWL v2.0 
code. WindowsMAKER v5 integrates into 
the Borland IDE and offers 50 features in 
addition to those offered by AppExpert. 

Features of WindowsMAKER v5 include: 
Visual Basic-like code editing, toolbar, and 
context-sensitive SmartMenus; a Visual 
Screen Designer, which includes drag-and- 
drop editing and a configurable tool palette; 
and a Preview Mode which lets users pre- 
view and test run an application before com- 
piling. WindowsMAKER v5 also includes 
Switch-It Code Generation Modules (SIMs), 
which let users switch to any language or 
major C++ library during the development 
of an application. Users can choose to auto- 
matically generate ANSI C, MFC and OWL 
from one design. Using WindowsMAKER 
v5, users can start a project and decide the 
type of code to use later and target Windows, 
Win32s, and Windows NT. 

Other features of WindowsMAKER v5 
include: toolbar support; application tem- 
plates; code generation for online help; spe- 
cial effect support for fonts, colors, 3D 
buttons, patterns, and 256-color bitmaps; 
style and property setting support for con- 
trols; MDI application support; and Ex- 
tended Functionality Modules (EFMs). 

WindowsMAKER Professional v5 in- 
cludes the ANSI C SIM and is $995. Regis- 
tered users of WindowsMAKER 
Professional v4 can upgrade for $269. For 
more information contact Blue Sky Software 
Corporation, 7486 La Jolla Blvd., Suite 3, 
La Jolla, CA 92037, (800) 677-4946 or 
(619) 459-6365; FAX: (619) 459-6366. 



National Information Systems 
Releases ACCENT STP 

National Information Systems, Inc. has 
released ACCENT STP (Sun Transition 
Pack) v2.0, a source code translator for Sun 



Select Software Upgrades C++ Designer 



Select Software Tools has upgraded C++ 
Designer, an MS-Windows-based object ori- 
ented analysis and design tool, which in- 
cludes Microsoft's MFC2 Library and the 
Borland Owl Library. Based on Rumbaugh' s 
Object Modeling Technique (OMT), C++ 
Designer lets the user structure systems 
graphically, adding classes and relationships 
using the GUI. The most recent release al- 
lows users to select from classes available in 
the Microsoft library or from their own class 
library. Header files for C++ can be gener- 
ated from the design and linked into the 
Visual C++ environment. 

Features of C++ Designer include: Win- 
dows CUA compliance; MDI interface; a 
data dictionary browsing capability; access 
control via user-ID; export facility to clip- 
board or to Windows metafile; project ad- 
ministration including versioning, backup, 
restore, and off-line; and multi-page print- 
ing. C++ Designer also supports the object- 
oriented and C++ features including: single 
and multiple-class inheritance; class proper- 
ties such as attributes and operations; asso- 



ciations including multiplicity, roles, quali- 
fiers, and specialized forms such as aggrega- 
tions; defining the access, virtual and static 
nature of attributes and operations, and the 
access and virtual nature of base classes; and 
storage of additional descriptive and con- 
straint information for classes, attributes, op- 
erations, and associations. 

C++ Designer can be integrated with 
Borland's C++ and Turbo C++, and Mi- 
crosoft's Visual C++. It can also be config- 
ured to integrate with other Windows IDEs. 
Code frames can also be generated from C++ 
Designer. Code is compatible with most C++ 
compilers including Borland, Microsoft, and 
Clarion TopSpeed. 

C++ Designer is $295 per user, including 
free technical support via a toll free number. 
Upgrades are sold separately. Users who 
have purchased C++ Designer within the 
past three months will receive the MFC2 
library at no cost. For more information con- 
tact Select Softw are Tools, Ltd., 1526 Brook- 
hollow Dr., #84, Santa Ana, CA 92705, (714) 
957-6633; FAX: (714) 957-6219. 



developers who plan to migrate their OPEN 
LOOK applications to Motif and the Com- 
mon Desktop Environment. ACCENT STP 
supports Motif vl.2 and X11R5 on Sun OS 
v4.1.x , and Solaris v2.x. According to NIS, 
ACCENT STP will translate 80% to 100% 
of the C/C++ application source code pro- 
duced by XView, OLIT, or Devguide GIL 
files, including header files, where there are 
equivalent resources offered in Motif. The 
translated output will be recognizable Motif 
C or C++ source code. 

Features of ACCENT STP v2.0 include 
support for "drag and drop," TTY widgets, 
and internationalization support. Other fea- 
tures of ACCENT STP include: compliance 
to the Motif standard, compatibility with 
Solaris v2.4/COSE CDE, and application 
portability to multiple hardware platforms. 

ACCENT STP consists of four optional 
modules. The Devguide Conversion, XView 



Conversion, and OLIT Conversion modules 
are $4,995 each. The WindowMaker GUI 
Editor is $1,495. Motif consulting and train- 
ing are also available. ACCENT ToolKit, a 
Motif library and OPEN LOOK ToolKit 
which helps support OPEN LOOK users 
after the source code is translated, is avail- 
able for $2,495 when purchased with AC- 
CENT STP. For more information contact 
National Information Systems, Inc., 4040 
Moorpark Ave., Suite 200, San Jose, CA 
95117, (800) 441-5758; FAX: (408) 246- 
3127; e-mail: info@nis.com. 

O 

Inmark Releases zApp Interface Pack 

Inmark Development Corporation has re- 
leased the zApp Interface Pack, an add-on prod- 
uct to its C++ class libraries. zApp is a portable 
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StratosWare Releases MemCheck for ANSI and K&R Platforms 



StratosWare Corporation has released an 
ANSI-compliant source code version of 
MemCheck, its error-detection tool for 
C/C++. MemCheck can be used for develop- 
ment projects built with ANSI or K&R com- 
pliant C/C++ compilers. 

MemCheck for ANSI and K&R can de- 
tect memory overwrites and underwrites, 
memory leaks, heap corruption, and out-of- 
memory conditions, and requires no source 
code changes for most projects. MemCheck 
integrates with existing C/C++ code and 
works at run time to identify errors by source 
file and line number. The error messages 
may be directed to the screen, written to log 
files, or sent in network or e-mail messages. 

MemCheck for ANSI and K&R includes 
source code and requires no debugging in- 



formation and no special compilation op- 
tions. Developers may ship applications with 
MemCheck linked in, royalty-free, allowing 
detection of errors at beta or customer sites. 
According to StratosWare, applications with 
MemCheck linked in run unchanged and at 
full speed. MemCheck may be switched on 
or off at run time, linked out via a "Produc- 
tion" library, or compiled completely out 
with no source code changes. 

MemCheck for ANSI and K&R is $199. 
StratosWare offers free technical support via 
fax, CompuServe, Internet, and a toll free 
number. For more information contact 
StratosWare Corporation, 1756 Plymouth 
Rd, Suite 1500, Ann Arbor, MI48105, (313) 
996-2944; FAX: (313) 747-8519. 



C++ Application Framework that gives ap- 
plication developers cross-platform port- 
ability through object-oriented C++ classes. 
zApp v2.0 is shipping on Windows, Win- 
dows NT, DOS Test, DOS Graphics, and 
OS/2. 

The zApp Interface Pack augments zApp 
by providing a set of additional classes that 
add graphical elements to applications. 
Classes in the zApp Interface Pack (ZIP) 
provide applications with toolbars and status 
lines, 3D custom controls, bitmap buttons, 
and a table object. 

Quoting Howard Love, President and 
CEO of Inmark, "Developers can now incor- 
porate the most advanced features of modern 
applications with just a few lines of code. 
Toolbars, spreadsheet-like tables, and other 
high-level controls, which would normally 
require weeks or months of engineering 
time, are now available to developers with 
just a few lines of code." 

Demonstration software of zApp is avail- 
able on the Inmark BBS. For more information 
contact Inmark Development Corporation, 
2065 Landings Dr., Mountain View, CA 94043, 
(415) 691-9000; FAX: (415) 691-9099; BBS: 
(415) 691-9990, CompuServe GO INMARK 



Quadralay Ship UDT for C/C++ 

Quadralay Corporation has begun ship- 
ping UDT for C/C++ v 1.2, an open UNIX 
development environment. UDT for C/C++ 
works with existing tools and code base, and 
acts as an incremental front end to existing 
compilers and other development tools. Fea- 
tures of UDT for C/C++ include: source 
code browsing, editing, project manage- 




ment, compiling, and prototyping for C++ 
classes and libraries. 

UDT for C/C++ v 1.2 supports SPARC 
SunOS v4.1.x, SPARC Solaris v2.x, Intel 
SCO Open Desktop, Intel Solaris v2.x, HP 
9000/700, and the RS/6000. UDT for C/C++ 
vl.2 single and multiple licenses are $595 
and $795 per seat respectively. A free, thirty- 
day evaluation with online documentation is 
available via anonymous ftp from ftp. quad- 
ra lay. com (192. 195.32. 1) or by request. For 
more information contact Quadralay Cor- 
poration, 8920 Business Park Dr., Austin 1 
78759, (512) 346-9199; FA 
9997; e-mail: info@quadralc 

Sector Seven Releases MakeMaster v2.6 

Sector Seven has released MakeMaster 
v2.6. MakeMaster (formerly DEPGEN), 
reads C source code and include files to 
create makefiles. Features of MakeMaster 
v2.6 include: support for C++, an optimized 
file search algorithm, flat dependency lists, 
relative directory references, and custom 
compiler command lines. 

MakeMaster v2.6 supports multiple disk 
and directory projects, cross-compilers and 
linkers, libraries, and DLLs. MakeMaster 
v2.6 runs under DOS v3.3+, and supports 
ANSI C and C++, Borland's Turbo Make, 
and Microsoft's NMake. MakeMaster v2.6 
is $49.95. For more information contact Sec- 
tor Seven, P.O. Box 11391, Burke, VA 
22009, (703) 866-9477. 



□ 

Stewart, Dufour and Gossage 
Distributes ProminareTM 

Stewart, Dufour and Gossage Ltd. have 
begun distributing Porninare Inc.'s Promi- 
nareTM in North America. ProminareTM 
combines a graphically oriented GUI design 
and code generation tool with an integrated 
development environment and a program- 
ming editor. The GUI development part of 
ProminareTM supports PM controls includ- 
ing those for MMPM/2 and Pen-PM. Promi- 
nareTM supports C/C++ compilers and 
CommonView. The GUI tool also supports 
direct creation of resource files as well as 
programming code. 

According to the company, the inte- 
grated development environment of Promi- 
nareTM eliminates most of the common 
mistakes encountered in trying to build OS/2 
applications. ftominareTM's graphical in- 
terface supports compiler-independent 
specification of common options required 
for compiling and linking programs. The 
IDE works with the programming editor to 
manage compiler and linker-detected errors. 

ProminareTM' s prograrnming editor is 
PM-based but performs, according to the 
company, like a character-based editor. The 
editor is integrated with the DDE and the GUI 
design tool and provides links to on-line help 
for the IBM Toolkits. The single-user and 
network versions of ProminareTM are $895 
each. Additional workstation modules are 
$795. There are no run-time fees or royalties. 
For more information contact Stewart, 
Dufour & Gossage Ltd., 210-1730 Court- 
wood Cr., Ottawa, Ontario, K2C2B5, Can- 
ada, (613) 225-2121; FAX: (613) 225-2624; 
BBS: (613) 225-2968. 



DDC International A /s Introduces 
1 st OBJECT EXEC 

DDC International A / s has introduced 
l s( OBJECT EXEC, a C++-based real-time 
operating system aimed at industrial use. 
DDC-I regards C++ as a highly suitable 
candidate for safely solving control prob- 
lems, and expects its run-time system to find 
uses from electronic measuring systems to 
life and safety-critical appplications. Ac- 
cording to DDC-I, their C++ run-time sys- 
tem can facilitate rapid development of 
complex systems and advanced communica- 
tions with the switches, sensors, and motors 
used in new designs. 

For more infomation contact DDC Inter- 
national A/ Sl Gi. Lundtoftevej IB, DK-2800 
Lyngby, Denmark, +45 45 87 11 44; FAX: 
+45 45 87 22 17; Telex: 37704 ddci dk. 
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□ 

Network Dynamics Upgrades Internationalization Toolkit 



Network Dynamics has released the In- 
ternationalization Toolkit v3.0. The toolkit 
is used by programmers to simplify and ex- 
pedite the internationalization/localization 
of software. Formerly known as "The String 
Externalization Tools," the toolkit has been 
expanded to include support for Windows 
and Presentation Manager string resource 
files, string length tracking, string file ap- 
pending, an extraction "undo" utility, string 
replacement, handling of static initialization, 
and a graphical user interface. 

Version 2.0 features like string extrac- 
tion, multi-byte Kanji support, software life- 
cycle support, string tagging, string caching, 
and string re-insertion have been expanded 
in version 3.0, with the intent of providing 



greater flexibility and ease of use. The user' s 
manual has also been expanded. A "white 
paper" on the subject of software interna- 
tionalization is available as an option. Sam- 
ple programs are included to illustrate DOS 
code page swapping and keyboard manipu- 
lation. 

The Internationalization Toolkit is avail- 
able in source code form for C/C++. Plans 
call for release of Turbo Pascal and Quick 
Basic versions in 1994. The Internationali- 
zation Toolkit supports DOS, OS/2, and 
UNIX platforms. The Internationalization 
Toolkit is $249.95 for a royalty-free source 
code license for up to 10 programmers. For 
more information contact Network Dynam- 
ics, (804) 220-8771; FAX: (804) 220-5741. 



Industry-Related News & Announcements 

□ 

Omega Systems Ships VERSIONS 

Omega Systems has begun shipping 
VERSIONS, a version control system for 
Windows. VERSIONS provides version 
control support for programmers by manag- 
ing multiple project resources including 
source code, documentation, or other files. 
VERSION supports varied file formats, in- 
cluding binary files, and doesn't limit the 
number or types of files which can be main- 
tained. VERSIONS is network-compatible 
and supports multiple developers working 
on the same project, allowing storage of both 
temporary and permanent versions of a file. 

Eschewing the approach of storing incre- 
mental changes to files, VERSIONS stores 
previous versions of a file in a "master pro- 
ject," a proprietary format that labels, main- 
tains, and tracks files for access to both the 
most current, as well as any past version. 
VERSIONS also tracks changes to a project 
either on a server or local workstation 
through the master project. Users check files 
into and out of the master project as needed 
and VERSIONS automates die process of 
determining which files need to be checked 
in or out. VERSIONS is $99. One copy of 
VERSIONS is required for each workstation 
in a networked installation. For more infor- 
mation contact Omega Systems, 5405 Alton 
Parkway, Suite 5A494, Irvine, CA 92714, 
(800) 458-5467 or (714) 253-6700; FAX: 
(714) 253-6712. 

□ 

EMS Professional Shareware 
Upgrades C/C++ Utility Library 

EMS Professional Shareware has up- 
graded its C/C++ Utility Library on CD- 
ROM. The library has over 1000 public 
domain and shareware products for pro- 
grammers using C/C++, Microsoft C, and 
Turbo C. The products are compressed on 46 
1.44 Mb diskettes or one CD-ROM. All 
products in the library, and 150 commercial 
products, are described in an indexed data- 
base which accompanies the library. When 
a programmer needs to locate a particular 
type of C/C++ product, he or she can find it 
by vendor, name, type, release date, or free 
text search across descriptions. The C/C++ 
Utility Library contains a variety of files, 
including: Array, Binary Tree, Communica- 
tion, Compression, Database, Debugger, 
Editor, Graphics, Linked List, Memory 
Management, MS Windows, MS Windows 
NT, Paradox Engine, Program Generator, 
Reference, Spreadsheet, String, TSR/ISR, 
Virus, and other types. 

The C/C++ Utility library is $59.50 on 
CD-ROM or $149 for the diskette versions. 
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A subset of the C/C++ library containing 
406 files for C++ only is available on 20 
diskettes for $59.50. All products come with 
a 30-day, money-back guarantee. For more 
information contact EMS Professional 
Shareware, 4505 Buckhurst Ct., Olney, MD 
20832, (301) 924-3594; FAX: (301) 963- 
2708; e-mail: eengelniann@worldbank.org. 

g 

Cadre Technologies Introduces 
Ensemble Viewer 

Cadre Technologies Inc. has released 
Ensemble Viewer, an interactive 2-D and 
3-D graphical tool for visualizing C pro- 
grams. 

Ensemble Viewer supports browsing of 
program flow, data structure, and physical 
file structures. Ensemble Viewer provides 
interactive views of key program aspects by 
displaying program information and test re- 
sults that are stored in the Ensemble data- 
base. Ensemble Viewer lets the user interact 
with the software design, code, and files by 
viewing a graphical representation of the 
actual program structures. This interaction 
lets a user understand the program or see the 
impact of program changes without having 
to read through the source code. Ensemble 
Viewer is available for Sun SPARCstations 
and the company plans called for a release 
on HP9000 and IBM RS/6000 during the 
first quarter of 1994. Prices for Ensemble 
Viewer start at $2,400 depending on con- 
figuration. For more information contact 
Cadre Technologies Inc., 222 Richmond St., 
Providence, RI 02903, (401) 351-5950; 
FAX: (401)351-7380. 



□ 

TerraLogics Upgrades 
Mapping Software Toolkit 

TerraLogics, Inc. has upgraded Ter- 
ra View, its geographic mapping software 
development kit. Terra View v4.0, lets devel- 
opers embed geographic maps directly into 
the source code of Windows applications 
developed with Microsoft's Visual C++ and 
C/C++ v7, Borland's C++ v3.1, Gupta's 
SQL Windows, and Powersoft' s PowerBuil- 
der. 

Features of Terra View v4.0 include: ras- 
ter data support, which lets developers su- 
perimpose TerraView data maps over aerial 
photographs or satellite images; style sheets, 
which are used to customize map displays; 
dynamic renditioning, which supports style 
changes for a single use of a map; and faster 
updating of mobile symbols for real-time 
tracking and display applications. Ter- 
raView v4.0 lets map users access data from 
many database managers, including Gupta 
SQLBase, dBASE, and Oracles, as well as 
Defense Mapping Agency ' s Digital Chart of 
the World and the Census Bureau's 
Topologically Integrated Geographic En- 
coding and Referencing (TIGER) data. 

TerraView v4.0 is available for MS-DOS 
and Windows, Apple Macintosh, and UNIX 
systems from SUN, HP, and IBM. For more 
information contact TerraLogics, Inc., 600 
Suffolk St., Lowell, MA 01854, (508) 656- 
9900; FAX: (508) 656-9999. 

PractiSys Releases STORC GOLD v2.0 

PractiSys has released v2.0 of STORC 
GOLD, its Windows form conversion tool. 
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Computer Applications Specialists has 
introduced ProMet, a C/C++ metrics utility. 
ProMet measures program size, number of 
comments and comment density, McCabe's 
and other complexity measurers, level of 
nesting, number of program jumps, and 
number of literals. These measures provide 
quantitative data for estimation of effort and 
conformance to programming style guide- 
lines. 

In addition to calculation of metrics for 
each function and each module, ProMet pro- 
vides program summary data and a "Top 
Ten" report that highlights the ten functions 
that have the highest metric scores. The Top 



Ten functions are presented both in a file list 
and as a graph to highlight the code sections 
that have the highest likelihood of having 
errors. The Top Ten list lets testing and re- 
view resources focus on code areas that are 
the most complex and may suggest the need 
for additional oversight. 

ProMet is $99 and comes with a manual 
that provides a background on software met- 
rics and their use. For more information con- 
tact Computer Applications Specialists, 
9948 Hibert St., Suite 103, San Diego, CA 
92131, (619) 695-2600; FAX: (619) 695- 
0794. 



STORC GOLD v2.0 lets Microsoft Visual 
C++ developers directly import Visual B asic 
.FRM files into C++ projects, reusing both 
form design and VBX controls. 

STORC GOLD v2.0 is $45.93 per copy 
per single user. Developers can download a 
fully-functional evaluation copy from Com- 
puServe (GO WINSDK or GO MSB ASIC), 
or can obtain a copy from PractiSys for $3. 
For more information contact PractiSys, 
4767 Via Bensa, Agoura, CA 91301, (818) 
706-8877. 



Digital Information Systems Corporation 
Ports PVCS to Alpha AXP 

Digital Information Systems Corpora- 
tion and Digital Equipment Corporation 
have ported Intersolv' s PVCS Version Man- 
ager v5 and PVCS Configuration Builder v5 
products to Digital's Alpha AXP. Under the 
terms of the agreement, DISC is porting, 
distributing, and providing technical support 
for PVCS products on operating systems not 
supported by Intersolv. DISC has completed 
ports to OpenVMS, VAX/VMS, OSF/1 , and 
several UNK-based platforms. 

Features of PVCS Version Manager v5 
include: SQL support facilities, expanded 
file support, user-defined delta generation, 
and internationalization capabilities. Fea- 
tures of PVCS Configuration Builder v5 in- 
clude: run-time diagnostics, build 
techniques, directives, and build script com- 
pilation capabilities. 

The price for PVCS Version Manager v5 
starts at $599 for a 1-4 user license and 
Configuration Builder starts at $399. For 
more information contact Digital Informa- 
tion Systems Corporation, 11070 White 
Rock Rd, Rancho Cordova, CA 95670, 
(800) 366-3472 or (916) 635-7300; FAX: 
(916) 635-6549. 



Odyssey Development Releases 
ISYS Search Engine 

Odyssey Development, Inc., has released 
the ISYS Developers' Toolkit, which in- 
cludes Odyssey's ISYS text retrieval soft- 
ware. Developers and OEMs can integrate 
the ISYS text retrieval engine into applica- 
tions for CD-ROM authoring, electronic 
publishing, or document and image manage- 
ment. ISYS can access textual information 
stored in word processor and other files. 
ISYS can read 28 word processor formats, 
as well as some spreadsheet and database 
files. Documents to be searched remain in 
their native formats. The Developers' 
Toolkit also lets OEMs develop External 
Access Modules. ISYS can then access and 
index "foreign" data sources, such at text 
stored in a relational database. 

The ISYS engine is available for Mi- 
crosoft Windows and MS-DOS. The ISYS 
engine can be called from many major lan- 
guages. Sample code is provided for C, Pas- 
cal, and Visual Basic. For more information 
contact Odyssey Development, Inc., 650 S. 
Cherry St., #220, Denver, CO 80222, (303) 
394-0091: FAX: (303) 394-0096. 



SLR Systems Upgrades OPTLINK 

SLR Systems Inc. has upgraded OP- 
TLINK for Windows. OPTLINK v5.0 for 
Windows lets developers generate com- 
pressed executables (.EXE) and Dynamic 
Link Libraries (.DLL). According to the 
company, OPTLINK v5.0 for Windows can 
reduce file size by 50 percent. Compressed 
EXEs and DDLs generated by OPTLINK 
become self-loading and decompress auto- 
matically as segments are demanded. 



Industry-Related News & Announcements 

OPTLINK v5.0 supports Borland, Mi- 
crosoft, and Symantec C++ compilers. De- 
bugging support is included for Borland's 
Turbo Debugger and Microsoft's 
CodeView. As a DOS-hosted linker, OP- 
TLINK is distributed in two forms, real 
mode and protected mode (DPMI). 

OPTLINK v5.0 for Windows is $350. 
Registered owners of v4.0 will receive the 
v5.0 update free, while other previous own- 
ers can purchase the update for $165. For 
more information contact SLR Systems, Inc., 
1622 N. Main St., Butler, PA 16001, (412) 
282-0864; FAX: (412) 282-7965; BBS: 
(412) 282-2799. 



Segue Releases QA Partner 
for NT and OS/2 



Segue Software has released its QA Part- 
ner cross-platform GUI test tool for IBM's 
OS/2 and Microsoft NT. Using QA Partner, 
developers can test applications on either of 
these platforms, and the test scripts will be 
portable across the other platforms QA Part- 
ner supports, including Windows, Macin- 
tosh, VMS, and Motif. 

QA Partner for both IBM OS/2 and Mi- 
crosoft NT is $1,495. For more information 
contact Segue Software, Inc. 1320 Centre 
St., Newton Centre, MA 02159, (617) 969- 
3771 :FAX: (617) 969-4326. 

□ 

Intel Ships Plug and Play Kits 

Intel Corporation has begun shipping 
three Plug and Play Development kits. The 
kits are designed to help developers in mak- 
ing PCs easier to configure. The Plug and 
Play Kits contain the software to perform the 
automatic configuration of new Plug and 
Play cards and Plug and Play-ready systems. 

The first kit, the "Plug and Play Kit for 
MS-DOS and Windows," includes a DOS 
driver, interface libraries, a configuration 
utility, a VHDL description for an ASIC 
implementation, and reference manuals. The 
second kit, the "Plug and Play BIOS En- 
hancements Kit," contains BIOS software 
that detects and configures PCI and Plug and 
Play ISA add-in cards. Software is available 
in source code form. The third kit, "The Plug 
and Play ISA Hardware Demo Kit," contains 
a functional audio Plug and Play ISA demo 
card and Windows v3.1 Virtual Device 
Drivers. The kit also includes diagnostics, 
board schematic files, and speakers. Bun- 
dled with this kit is the "Plug and Play Kit 
for MS DOS and Windows." 

The Plug and Play ISA Hardware Demo 
Kit is $895. For more information contact 
Intel Literature Packet #F8P01, P.O. Box 
7641, Mt. Prospect, IL 60056, (800) 548- 
4725. 
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Call for Papers 




The C Users Journal is seeking articles on the topics be- 
low. If you have an idea for a related story, or experience that 
would qualify you especially to write on one of these topics, 
please write: 

P.J. Plauger, Senior Editor 
The C Users Journal 
1601 W. 23rd St., Suite 200 
Lawrence, KS 66046-2700 
(913) 841-1631 

The C Users Journal is written by practicing programmers 
for practicing programmers. We insist on practical treatments 
of real programming problems, or on tutorials that make the- 
ory or complex issues more accessible to practicing program- 
mers. In place of product reviews, we publish user reports that 



show — with insight backed by experience — how to use 
commercial products that aid the program developer. Our em- 
phasis is on C and C++, or on tools used in conjunction with 
these languages. 

We pay at rates that are competitive with other national 
technical journals. We believe that our editorial assistance is 
better than most. You don't have to be a professional writer to 
meet our acceptance criteria, but you must have something to 
say. Ask for a copy of our Author Guidelines. 

A proposal consists of a brief abstract and outline, prefer- 
ably totalling no more than one page, and a brief resume of 
your qualifications. You must submit your manuscript on an 
MS-DOS diskette, or via email (marc@rdpub.com). Files must 
be in raw ASCII format, flush left, with one empty line be- 
tween paragraphs. 



Themes 

Software Tools 

Proposals Due 02/07/94 
Drafts Due 03/21/94 

Suggested topics: portable "shells" 
and toolkits; small programs that serve 
as useful building blocks for applica- 
tions; small programs that aid program 
development or analysis; reusable tools 
in a windowing environment; C/C++ li- 
braries that make tools more uniform. 

Overworked topics (require fresh 
perspective): heap trace analyzers, 
"make" utilities. 



Graphics 

Proposals Due 03/07/94 
Drafts Due 04/18/94 

Suggested topics: writing C or C++ 
code that ports easily among the major 
GUI environments; useful graphics 
classes and libraries; algorithms for 
drawing, shading, windowing, scaling, 
etc. that are efficient and/or elegant; 
techniques for visualizing data; manipu- 
lating gray-scale and color images. 

Overworked topics (require fresh 
perspective): graphics object classes, 
graphic file reformatters. 



Windows Programming 

Proposals due 04/08/94 
Drafts due 05/20/94 

Suggested topics: C++ class librar- 
ies and other scaffolding that simplifies 
programming under Windows; debugging 
under Windows; writing C/C++ code that 
is portable across Windows/Mac/X; use- 
ful small Windows utilities in C/C++; 
using C/C++ to coordinate (script) run- 
ning other programs; simplifying input 
under Windows. 

Overworked topics (need fresh per- 
spective): simulating stdout or stderr in 
windows. 



Also 



Features 

If you have an idea for an article 
that you think might help other C or 
C++ programmers, you don't have to 
wait for a more-or-less appropriate 
ne to roll around. Send it in any- 
s. Uses for C and C++ are growing 
too rapidly to count, particularly in a 
mere twelve categories. So use your 
imagination, and we may use your 
words. 











User Reports 

If you are willing to share your ex- 
periences with a certain product, send 
us a user report. A user report is not a 
product review. It is a more anecdotal 
description written by someone who 
uses products to get useful work done. 
Instead of letting vendors trumpet their 
own products, we want you, the reader, 
to do it for them — or say why the 
trumpets should be muted. 





Book Reports 

If you are willing to share your 
opinion about a book you have read to 
improve your understanding of software 
development, send us a book report. 
Give your fellow programmers a brief 
synopsis: an overall evaluation of the 
book, listing the strong and weak 
points. Include suggestions for im- 
provement. For more information, ask 
for the Author Guidelines 
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We Have Mail 



Letters to the editor may be sent via email to 
CUjed@rdpub.com, or via the postal service to 
Letters to the Editor, The C Users Journal, 
1601 W. 23rd St., Ste. 200, Lawrence, KS 
66046-2700. 



Dear Mr. Plauger: 

There are a number of aspects of the current 
state of the art of software engineering that I 
find less than satisfactory. They are 

1) Bug-infested tools 

2) The dearth of productive engineering tools 

3) The programming languages themselves. 
First of all, I have used Lattice C, Turbo C, 

and Microsoft and Borland C/C++ compilers. 
Our group chose the latter two for their third- 
party and Windows support. First I used Lattice 
C 3.1. It didn't do floats but doubles seemed 
to work OK. Next I used Microsoft v5.0. It op- 
timized code out of existence. Because of that 
we switched to Turbo C/C++. It refused to do 
assignments of floating point {float or double) 
literals in the range between and 1! 

This problem only occurred when linking 
together 20-odd modules. In a three-module test 
program all worked fine. Due to project dead- 
line pressure I was never able to whack away at 
the 20-odd modules to the point where the prob- 
lem went away in order to determine its cause. I 
worked around it. This problem was also pre- 
sent in Borland C/C++ 3.0, but does not occur 
in version 3.1 with identical source code. I have 
seen two instances where Borland C/C++ 3.1 
handled the following snippet where the func- 
tion returns the value 1 by not taking the if. 

if ( funcO ) // returns 1 

do_something(); // never executed 

Changing this to the following worked, 
however: 

status = funcO; 
if ( status ) 
do_something() 

My first gripe about the state of the art is 
that compiler vendors seem to concentrate on 
features like IDEs, 32-bit versions (64-bit next, 
no doubt), Windows support, etc., while basic 
functionality is not solid. Floating point seems 
especially difficult for these people. (You'd think 
that after ten years of writing C compilers...) I 
really don't know if Borland C/C++ v3.1 has 
floating point problems; I just haven't seen any 
problems so far. Now if Borland and Microsoft 
are the least-buggy products on the market, I'd 
hate to see the others. I would love to be able 
to trust the compiler, but that seems to be wish- 
ful thinking. At least we have debuggers to go 
roto-rooting in the generated assembly code. 



More and more vendors are charging for 
phone support. Now I get to pay them for re- 
porting bugs in their products. Borland actually 
told me to call their 900 number to discuss a 
bug! No thanks! Along with the bug situation, I 
wish compiler error and warning messages were 
more accurate. In many cases I have to ask my- 
self, "Now what does it really mean?" I use 
PC-LINT religiously. To the compiler vendor's 
credit, error and warning messages have been 
getting better in recent years. 

Now lets add C++ on top of this whole mess. 
I enjoyed your article, "Programming Language 
Guessing Games" in Dr. Dobb's (October 1993). 
I agree of course with your suggestion to "pick 
a subset of the [C++] language that minimizes 
surprises, learn it well, and don't stray from it." 
The problem is that the compiler vendor chooses 
to support everything that looks like it will make 
it through the ANSI committee. If they can't get 
some of these simple things solid (like the func- 
tion return value example above) how can I trust 
them to do some of the complicated things you 
have described for C++? Even if I do restrict 
myself to a subset of the language, it could be 
that the other features induce bugs in the parts 
that I am using. The bottom line is that the ma- 
jority of our time is spent on maintenance. 
Compiler bugs cost us. Secondly, the support 
tools available do not help me with software 
engineering (as opposed to hacking which I de- 
fine as, "code it first without thought of design, 
document it later") as I would like. Diagrams 
are a neat idea, but then we have to translate 
the diagram into code by hand and translation is 
where errors creep in. Management might go for 
the time spent on diagramming if automatic code 
generators were available. Code generators for 
Windows screens and other user interfaces are 
generally available, but I haven't seen any for 
other parts of a program. A framework gener- 
ator would be nice. Hardware engineers have 
schematic capture and printed-circuit-board lay- 
out tools including auto routers, but as software 
engineers, we do analogous things by hand. Also, 
I've yet to see a decent cross-reference gener- 
ator after evaluating several. The ones with us- 
able output are way too slow. I use GNU CTAGS, 
but wish it did more. I know of no general pur- 
pose, highly configurable cross-reference gener- 
ator. We have written our own programs and 
editor macros to insert comment blocks for 
functions and modules and for extracting those 
into a Word document, but so much more could 
be done. I am beginning to write add-on tools 
for Codewright, a very extensible Windows pro- 
grammer's editor. Thirdly, despite some ugly fea- 
tures of C, I like it a lot (more than Pascal, 
Modula-3, Eiffel, etc.). For example, C overloads 
the static and void keywords, allows functions 
to return pointers to automatic variables, and vari- 
ous other gotchas mentioned in Andrew Kocnig's 
C Traps and Pitfalls. (Being able to execute an 
array of opcodes is a feature?) But for the sa- 



dist, C++ is a real treat. Now we have not two 
but three meanings of static and not two but 
four meanings of void'. 

C and C++ violate many of the accepted 
guidelines of language design. Many things can 
be done several different ways, much of it behind 
the scenes. I shudder whenever I read one of your 
articles concerning C++, your latest in The C 
User's Journal on the Standard C++ library in- 
cluded (P.J. Plauger, "Standard C: Developing the 
Standard C++ Library," CUJ, October 1993). I 
know that I cannot avoid learning C++, but hope- 
fully it will be replaced soon with something sim- 
pler. We need new paradigms and metaphors to 
handle advanced concepts. Languages will have 
to become more complicated, but they should be 
as simple as possible. I like the approach taken 
by Meyer in Eiffel of including an extensive set 
of libraries. The less I have to write myself, the 
more productive I am. Hopefully, libraries sup- 
plied with compilers are well thought-out and 
bug-free. I wish Borland C/C++ came with the 
library support that Eiffel or NextStep Objective- 
C does. A collection of third-party classes or li- 
braries does not have the consistency that a sin- 
gle-sourced library does. I have only touched the 
surface of some current problems in the software 
industry. What I would like to know is: 

1) Which in your experience are the least-buggy 

C/C++ compilers? 

2) Do you know of a diagrammer w/code gen- 
erator? What other engineering tools have 
you found to be helpful? 

3) Do you know of any cross-reference generator 

that outputs a list of identifiers including the 
module name, line number, and function (if 
any) they were found in, and that is fast? 

4) What do you think of Modula-3, Eiffel, and 

IBM's Object REXX? Thank you in ad- 
vance for your help. Thanks for your excel- 
lent articles. Please keep them coming. 

BRUCEDICKEY&fAX. MICRON. COM 
Bruce Dickey 
Micron Semiconductor, Inc. 
2805 E. Columbia Rd., MS 892 
Boise, ID 83706 

Whew! You raise a whole slew of issues. I 
agree with you almost across the board, except 
that I am a bit more sympathetic to the plight of 
all those compiler vendors out there scrabbling 
for market share in a turbulent industry. I guess 
that comes from selling compilers myself for ten 
years. Growing complexity seems always to off- 
set gains in our ability to manage software de- 
velopment and reduce shipped bugs. 

I don't know how to answer any of your 
questions at all well, but I invite other readers 
to chip in. My opinion of Modula-3 and Eiffel, 
for what it's worth, is fairly simple. Both offer 
interesting combinations of features, but neither 
has quite pulled off the synergy of C or C++. 1 
don 't know enough about REXX to comment. — 
PIP 



The C Users Journal 



— March 1 994 



Page 137 



Dear Editor, 

My compiler issues an error diagnostic on 
the call to g in the code fragment shown in 
Listing 1, but no error on the call to f The er- 
ror claims that there is a pointer mismatch in 
the argument. I am using Digital's DEC C com- 
piler under OpenVMS on their new Alpha proc- 
essor. When I contacted DEC's customer serv- 
ice, they explained that the ANSI standard al- 
lows conversion from a pointer to a qualified 
type to a pointer to a non-qualified type, but 
does not allow 'ignoring' the qualifier for a 
pointer to a pointer to a type. Their argument 
seemed somewhat niggling to me, so I wanted 
to appeal to a higher authority. How do you 
think a compiler should handle this code 
(shown in Listing 1)? Sincerely, 

Dick Hile 
T and B Computing, Inc. 
24 Frank Lloyd Wright Dr. 
P.O. Box 302 - Lobby A 
Ann Arbor, Michigan 48106-0302 

DEC is correct. The distinction may appear 
niggling to you, but we meant to do it that way 
when we wrote the C Standard. — pjp 

Dear Mr. Plauger, 

I would like to add my two cents' worth to 
Mr. Mike Musielski's comments (CUJ, October 
1993) on the nature of C as a language. ("Is C a 
language?" was his opening question.) The 
short answer to that question is, no, C is not a 
language. Neither is any programming lan- 
guage. The programming-as-writing analogy is 
interesting, but like most analogies it is partly 
true and partly dangerous. 

A programming language is really a nota- 
tion system: defined narrowly, conceived as a 
formal means of expression, and limited in its 
range of expressiveness, at least when com- 
pared with natural languages. No programming 
language is used as an end in itself (except of 
course by participants in Obfuscated C con- 
tests), whereas a natural language is used that 
way all the time by artists whose only goal it is 
to explore the language's poetic possibilities. 
This is the main reason why programs, no mat- 
ter how short, cannot be compared to short sto- 
ries or other forms of fiction. 

Nevertheless, there is a basis for the analogy. 
Like natural languages, programming languages 




char x; 

char *xp = &x; 
char **xpp = ixp; 
void ffconst char *cp) 
{) 

void gtconst char **cpp) 


void a(void) 
( 

/* Call to 'g' gets pointer mismatch error */ 
f(xp); 
g(xpp): 
) 

/* End of File */ 




Programmer's 
Market 



CRTX 

EMBEDDED REAL-TIME 
MICRO KERNEL 



• Small Embedded High Performance 

• ANSI Standard "C" 

• Intertask Communication 

• Event Flags (SEMAPHORES) 

• Delayed Task Schedulding and 
Execution 

• Timer Services 

• Portable 

• Compatible With Most "C" Compilers 

• Porting and Consulting Services 
Available 

Complete with source for $99.00 

Flanster Software P.O. Box 709, Ramona, CA 92065 
(619) 788-5678 
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The fast path to Turbo Debug 



1 c 



^ High Level Debugger for all 
popular 8051 C compilers 

^ Key Compatible with Borland's 
popular Turbo Debugger 

^ Over 14 views including Call 
Stack and Execution Trace 

High-Speed Simulator 

7" Full support for derivatives from 
Intel, Philips, Siemens, Dallas 
including all on-chip peripherals 

Nohau EMUL51 Support 

Both Standard & Advanced Trace, 
Bankswitch emulator, and Serial box 

ROM Monitor Version 

Royalty-free source for development 
as well as in-field debugging 



Ask about our Competitive Upgrade Offer 
30-day money-back guarantee! 
Call for vour FREE Working Demo 



JF ChipTools® 

■■ 905-274-6244 FAX 905-891-2715 
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RTCARD 




INTELLIGENT SERIAL 
COMMUNICATIONS 

REALTIME 



Offload Serial Interrupt 
overhead . . . for only S395 

• DUAL PORT • DMA or I/O 

• SYNC / ASYNC • RS-232/RS-485 

• 8K or 32K RAM • BAUD TO 96K 

• 18MHz 80C31 pP • 85C30 MPCC 

Use our driver software . . . 
or download your own < o(l< 
Drivers available lor: 

• DOS • ()S/.» • XENIX 

• Custom Apptit at ion 

Ask ,i/)oii( our rVt'M 
Low Cost, Dual P<» 
RS-212 to KS-4ll r > 
Converter - RTX4tl r > 
ONLY$195 




REALTIME 
CONTROL, INC. 

(904) 373-2626 
(800) 232-0485 



<■ Request 191 on Reader Service Card ❖ 




Toolkit (or DOS & Unix 



CRUSHER! 



nATA & ARCHIVE 
UAIA MANAGEMENT 

COMPRESSION 

FOR C, QUICKBASIC & UNIX 



LIBRARIES $189.95 SOURCE $49.95 

Multi-file archives 
Subdirectory processing 
High compression ratios 
Portable archives & source code 

§M Micro 

S£a Development For free 

(606)268-1559 fax info, call 

(606) 266-0726 fax (800) 234-01 41 
(606)268-1251 bbs doc #1151 
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Software Engineers/Programmers 



Opportunities exist nationwide for 
professionals with the following 
experience: 

C, C++, MS/Windows, NT, Unix/ 
Motif, PM, OOP, GUI, Macintosh, 
SQL, Sybase, Informix, Oracle, or 
Ingres. 

If you have any of the above skills, 
call or fax us at: 



Group 

5390 Peachtree Industrial Boulevard • Suite 210-D 
NorcroBS, Georgia 3007 1 • (404) 36d-07 1 1 
Fax (404) 368-0713 
Fee Paid by Employer 
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Earn Your High-Tech Degree 
While Working Full Time 

New book High-Technology 
Degree Alternatives shows how 
to get your college degree 
without quitting your job, 
attending night school foryears, 
or breaking your budget. All 
degree programs are accredited, 
and many do not require 
classroom attendance. Use VISA 
or MC. $21 .95 + $3.75 s/h. 

PPI, Dept. 807 
(800)426-1178 
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C++ SOURCE CODE 



ImageSeff 



The World s I 
Publisher ol C++ 




ISCL 1M containing more than 
140 volumes of high 
quality C++ source code 
(both shareware and 
freeware) including: 
• Neural Nets • Compilers 
1 Communications • GUIs 
Tutorials • Matrix/Numerical 
• Memory Management • Databases/ 
ISAM • Utilities (e.g. Demangler, Beautifier, etc.) 
• Graphics • And Much, Much More 

AllForOnly$99"(onCDRom) 

Also available on 3.5" and 5 1/4" 

Contact: ImageSoft Incorporated 

2 Haven Avenue • Port Washington, New York 1 1050 
Tel: (516) 767-2233, Fax: (516) 767-9067 
EMAIL: nicdhuplimageliscl 
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TM 

CRYPTO/CRAM 

Data Encryption/Data Compression 
Developers Distribution Kit. 

Multi-file data encryption whh Infinite layering ! 
Build self-Xtracting compressed Mies. 
Distribute self-Xtracting flies royalty freel 
Compress multiple files easily with a powerful 
user interface. Utilities included: 

CRAM, UNCRAM. Xtract. RUND. RUNK. and 
DMARZSXF. Plus a simple SETUP template. 
Run executables from CRAMed files. 

Create "distribution logs", "security logs", and 
utilize muhple key access codes. 

Entire system Is file attribute aware. 

TM 

CRYPTO/CRAM + distribution kit SI 49.00 
Shareware version $30,00 
1-800- W1N-80 86 



Diversified Sciences Co. 








IMWHelp 



Window/ Help Authoring Tool 



Professional quality help files 
in 1/4 the time!! 

• Edit text directly in IMWHelp 

• Build hypertext links to: topics, 
definitions, subjects 

• Glossary automatically created 

• Bitmaps incorporated 

• Desktop publishing features 

• Print topics, help file, customized 
reports 

• Spell check, replace verify/all 

• Easily reorganize topics, subjects, 
keywords 

• Uses Microsoft Help Compiler 

Single User: $89.95 

MC & Visa accepted, Shipping additional 

Call: IMCSI (212) 319-1903 

425 Madison Ave., New York, NY 10017 
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TCP/IP 



NETWORKING PROTOCOLS 



Add them to your 
System Designs with: 
FUSION Developer's Kit 

• FUSION TCP/IP protocol suite 

• Flexible architecture - C source 
code 

• Used in hundreds of process 
control, embedded systems, and 
end-user designs 

• Full support, training, consulting 
and porting services 

(800)541-9508 (805)484-2128 
Fax (805)484-3929 
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DEVELOPERS! AEgEAOIIEPE! 
GOING INTERNATIONAL? 

Our Internationalization Toolkit will move 
your package to the international market! 

■ Quickly and easily multi-lingualize your software. 

■ Add additional user languages with no source code 
modification. 

■ Generate Windows string resource files. 

■ Support double byte character sets, such as Kaoj i. 

■ Dynamically switch user languages at runtime. 

■ Predict and track the growth of strings during their 
translation. 

■ Track all information about each string used in your 
software. 

■ Insert translated strings back into your source code. 

■ Maintain your software more easily and reduce 
your static data space requirements. 

NEW! Version 3.0 just released! 
More features than ever before! 

$249.95 for C source code and site lice:ise. C, C+ + , BASIC, 
and Pascal. No royalties. Used world-wide by many For- 
tune 500 companies on DOS, Windows, Unix, and OS/2 
platforms. Complete translation services also available. 

Network Dynamics, Inc. 

2225 S. Henry Street, Suite L-2 
Williamsburg, VA 23185 
Phone (804) 220-8771 Fax (804) 220-5741 



Decode color TIFF image 

from HP scanner 

Display as EGA, Gray-Level, & 

VGA 640x430x256 colors 

Up to 64-level Halftone printing 

on HP LaserJet & Dot-Matrix 

Production MS C source code 

for DOS or C/SDK for WINDOWS 

$59 each, or $99 for both DOS 

& WINDOWS 

Custom Programming Available 
Order from: 

Digital Computing System 
17250 West 12 Mile Rd. 

Suite 103 
Southfield, Ml 48076 
(810) 557 - 0220 
(810) 557 - 0225 (FAX) 
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PROTECT YOVR 
SOFTWARE TODAY 

Since 1 986. thousands of companies worldwide 
have chosen Az-Tech Software as partners in 
their fight against Software Pirates. Why? 
Because Az-Tech offers you: 
■DATE & EXECUTION LIMITS' COMPRESSION 
■ENCRYPTION * SERIALIZATION* REMOTE RESET 
All of this and now our newest releases in both 
Hardware and Software based protection: 



EVER LOCK 3.0 

OPTION BOARD SAFE 
CPU LOCK 

REMOTE REGISTRATION 
CD ROM LOCK 
WINDOWS COMPATIBLE 



EVERKEY LOCKS 

We have combined the Versatility 
of Az-Tech Software and the ONE 
WIRE Hardware Compatibility of 
Dallas Semiconductor in this new 
package. 



EASE 




with over 14 new features you have 
asked for over the years. If Software 
based protection is what you need, 
don't settle for anything less than 
EVERLOCK 3.0. 

These systems are easy Id use and most importantly' „ 
they work! No other product can provide the Compatibility, 
Flexibility, Ease of Use and Degree of Protection that you 
receive with Az-Tech products. 

Call Today For A FREE DEMO 

el-800-227-0644 
Az-Tech Software, Inc. 
201 East Franklin. Suite 11 Richmond, MO 64085 
(81(11 776-2700 LEADERS LV SOFTWARE SECURITY FAX (816) 776-8398 
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You don't track 
your bugs? 



Save up to 18 fields 
per bug, you 
choose field 
names/values 



Automatic 
notifications 

ad-hoc reports, 
graphs, stats 

Free demo disk 



BugTracker $295 
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Been There - Done That Software 
508-486-9193 
FAX: 508-486-8448 
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do evolve and adapt themselves to new situ- 
ations and conditions. And as they do, new vo- 
cabulary creeps in, functions begin to overlap, 
and things begin to get — well, messy. Even 
standards cannot clear up all ambiguities: there 
will always be more than one way to skin a cat. 
You can say "pass away" or "kick the bucket," 
just as you can use strtol or dtol. Both ele- 
ments in each pair approximate, but do not ex- 
actly map, the same idea. How are you to rec- 
ognize when it is appropriate to use one and not 
the other? This is what Mr. Musielski wants to 
know. 

There are some useful texts out there. I sug- 
gest Mr. Musielski look at (again, if not for the 
first time) The C Programming Language, by 
Kernighan and Ritchie. Another book I have 
found useful on occasion is C Lab Notes, by 
Flanders and Holmes. This book has a nice fea- 
ture in that each chapter has at its head a list of 
the tasks that are to be explored inside ("for- 
ward and reverse scrolling," "sending a mes- 
sage to another node," etc.). And, not least, The 
C Users Journal is itself very instructive in 
matters of language use. None of these texts is 
consciously "literary," but all take the implicit 
stance that a programming language is an idiom 
to be mastered. Mastering the language (your 
"material") is the goal of literary writing as 
well. 

I think what might be very beneficial to Mr. 
Musielski (and others, myself included) would 
be a kind of reverse dictionary: a list of com- 
mon tasks along with the range of functions, 
procedures, tools, etc. that could be used to ful- 
fill each task's requirement. Such a book could 
not possibly be exhaustive and the organiza- 
tional problems would be daunting, but a good 
text like this might be useful enough to be a 
starting point. Of course, as writers learn from 
writing, programmers learn best from program- 
ming. There is still no effective substitute for 
trial and error-many trials, many errors. 

Sincerely, 

Michael Nichols 
1725 York Avenue 
New York, New York 10128 

Thanks for your insightful comments. — pjp 
Editor: 

I found Robert Watson's "DMA Controller 
Programming, in C" (CUJ, November 1993) in- 
teresting, particularly of course the protected- 
mode details, but found his conclusion, "the 
technique is actually very easy to use" laugh- 
able, considering what he had just painstakingly 
documented. "Virtually impossible" is more 
like it. I agree with his further conclusion: that 
DMA is increasingly obsolete, since fast CPUs 
deal with dedicated card memory blocks more 
expeditiously (and of course the implication 
that such memory is relatively cheap in modern 
times — DMA was originally a cost as well as 
speed feature). 

I also think along the way he erroneously 
minimized the difficulties involved in getting 
hold of a DMA buffer in real mode ("in real 
mode, generating a DMA buffer is relatively 
easy"). I hope I'm missing something, but in 
my source where I tried to accomplish this 
there are three or four failed attempts com- 
mented-out, and I'm not at all happy with my 
current effort, shown in Listing 2. 
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Market 







International 
Software Careers 

The International Computer Professional 
Association gives you up-to-the-moment information 
and world wide contacts you need to find an exciting 
overseas assignment. Every two weeks you'll receive 
a detailed listing from international recruiters for soft- 
ware related jobs located throughout the world. Jobs 
like micro programming/analysis, software engineer- 
ing, system sales, LAN/WAN support, and others. 

As a member of the ICPA you become part of a 
dynamic international network of software profession 
als and technical recruiters. People with years of expe 
hence in the international software market who will 
show you how to find an assignment abroad. Call us to 
receive a membership package for this new global 
organization of software professionals. 
ICPA 

350 Townsend Street, Suite 301 M : 
San Francisco, CA 94107 USA 

24 hour Tel: 1 (415) 695-7618 
24 hour Fax: 1 (415)543-3022 
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SmartHcap" is an ANSI portable maHoc 
and new for DOS, Windows, NT, OS/2, 
UNIX and other platforms. Proprietary 
algorithms deliver speed improvements 
up to 100X versus other commercial 
mallocs, especially for large heaps in the 
presence of virtual memory. SmartHeap 
localizes data structures in their own 
heaps. Plus it includes numerous fixed- 
size and handle-based APIs. Debugging 
facilities isolate leakage, overwrites, 
double-freeing, wild pointers, and many 
other errors to responsible file/line/pass 
count. Exceptionally reliable - used by 
a "who's who" of commercial software 
publishers. No royalties. Source avail- 
able. 

CALL FOR FREE 
WHITE PAPER, BENCHMARKS, 
AND ERROR REPORTS 



Software Publishing, Inc. 



800-441-7822 / 206-525-8218 
FAX 206-525-8309 

Compuserve: 70751,2443 
Internet: devtools@mlcroquill.wln.net 



Communications Library 



MS DOS and Window* version*. 

• Run 4*10 ports at once - Interrupt driven 

• 8250 - 1 6550 UARTs • COM 1 to COM1 

• RTS - CTS How control • 300 - 1 1 5200 baud 

• DlglBoard PC/4 & PC/8 • 30+ library tunctlons 

• Extensive error trapping • Adjustable queues 

• Use any UART address • Use IRQ2 to IRQ7 
Includes example communications program In C 
With ASCII, XMODEM, and YM0DEM protocols. 
Get source to library, printed User & Reference 
manuals, quarterly newsletter, one year BBS & 
phone support. Or download run demo version 
from our support BBS (1 200 to 9600 baud, 8N1 ) . 

Order the Personal Communications Library for 

DOS (PCL4C) $65. Windows (PCL4W) $95, or 
both $135. Please add $3 S&H ($6 overseas). Your 
satisfaction Is guaranteed. 



MarshallSoft 
Computing, Inc. 



Post Office Box 4543 
Huntsville AL 35815 
205 881 4630 Voice / FAX 
205 880 9748 BBS 

"RMton»bly Prlcid 
Softwir* Tooli" 
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Need to reach 45,000 C/C++ 
programmers with information 
about your products? 

Advertise in: 



The P 



Users Journal* 



Call 913-841-1631 today 
for information about 
advertising opportunities in 
The C Users Journal. 

Advanced solutions 
for C/C++ developers. 

Brian Osborn - Continental Europe 
Ed - East. Christine - Midwest. Edwin - West. 



See The Whole Picture.! 

Let C Associates Expand Your Horizons!. 

C Associates' will expand your 
employment horizons as no other UNIX/ 
"C" placement service can. Just call us if 
you're looking for career advancement in: 

• UNIX Systems and Kernel Development • UNIX and C 
Trainers • Secure UNIX • TCP/IP and X.25 Commu- 
nications Software • Sybase, Progress, Informix, 
Ingres, Oracle, and Unify Relational Databases • 

• C 4 C++ Programmers • System Administrators 



Please fax or send resume to: 
C Associates 
attn: John Capozzi 
P.O. Box 15420 
Washington, DC 20003-0420 
Phone. (202)-544-0821 
Fax: (202) 547-8357 
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Phone Sound: Simple! 

For Windows/DOS Voice Mail & Fax Developers 



Printer Graphics Libraries 

PGL ToolKit is a set of easy to use libraries 
for generating device independent high reso- 
lution printer graphics on most popular print- 
ers. Provides 80+ functions to create vector 
drawings and/or print bitmapped images. 
Provides full control of printing (margins, 
layout, size, resolution, etc.) and supports 
parallel and serial port interfaces. Includes 
full support for C/C++, FORTRAN, Pascal, 
Basic, Clipper, & Assembly plus 32-bit 
support for C and FORTRAN. 

NO ROYALTIES! 

Only $245 (includes all language support) 
Source code: DOS - $595, UNIX - $995 

AnSoft, Inc. 
8254 Stone Trail Court 
Laurel, Maryland 20723 USA 
Voice/FAX: (301) 470-2335 
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Automated C & C + + 
Documentation! 



Hypertext right from your editor to 
answer questions like: "What does 
this function do? Show the code!", 
"Where is this function?", "What's 
the name of the class that...?", or 
"Are there similar functions?". 

SourceDoc (formerly PolyDoc) quickly 
and intelligently scans thru all your 
source code extracting, creating & 
categorizing information on functions, 
classes, definitions, etc. Workgroups 
have easy access to continuously up- 
to-dated info thru an interactive 
hypertext view, search, and print 
engine. SourceDoc also interfaces 
well with all Version Control Systems 
including: PVCS, RCS, and TLIB. 

Economical Network version available 

Intelligent Solutions, Inc. 

612/884-0200 FAX: 61 2/884-5860 



Is Parsing a BLACK HOLE? 

Not when you use AnaGram, the new 
LALR-1 parser generator. AnaGram is 
not just another compiler-compiler — it not 
only helps you solve your parsing problems, 
but helps you make them stay solved. 

With AnaGram you can have recursive 
parsers, multiple parsers in a single pro- 
gram, multiple instances of a parser, event 
driven parsers. All with clear, simple 
interfaces to the rest of your program. 

AnaGram's notation simplifies writing and 
modifying your parsers. AnaGram has 
extensive debugging aids. Even coverage 
analysis to verify your debugging! 

DOS, C/C++. 60-day money back guaran- 
tee. Free trial copy available. 

800-879-2577 Voice/Fax 508-358-2564 
CIS:72603,1763 jhoUand@world.std.com 

AnaGram" by Parsifal Software 
P.O. Box 219, Wayland, MA 01778 





MPW ($295); PC V123 (one volume 
$125; All $300); PC 386 ($225); PC 
Professional ($395); Sun UNIX ($495) 



m Programmer's 
^ Toolbox 



30 Day Money 
Back Guarantee 



Dialects: Borland C++; Microsoft C/C++; MPW C & 

C++; Think C; Turbo C; Zoretech C++; Unix C 



CLint™ - Syn ta tically d icck one or more files & generate 
ANSI function prototypes; CFlow™ - Determine/graph 
program organization, function and file 
interdependencies and runtime library contents; 
C Print™ - Reformat/beautify C & C++ source code; 
CXref™ - Cross reference and check symbol usage and 
identify unused files; CDecl - Translate and compose 
C/C++ declaration statements; CHilite™ - Highlight & 
print C/C++ source files (MPW only); pArc 1 ** - File 
archiver with great compression (DOS only); pLn™ - 
UNIX symbolic links in DOS; PMon™ - Programprofiler 
(DOS only); Cpp - flexible ANSI C & C++ preprocessor 



30+ productivity improving 
tool* for new code develop- 
ment, software maintenance, 
documentation, porting, 3rd 
party integration, ... 



Call: (510) 770-0858 

MasterCard Visa Accepted 
MMC AD Systems 

Box360«45 
Milpitas,CA95036 
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Add phone and 
s» ^ fax interfaces 
to your 'C 
programs. With 
the MULTI-VOICE and 
MULTI-FAX Toolkits. 



s Multi-Voice for Dialogic. Rhetorex, NewVoice, 

Bicom, Power Line II, VBX - S599 
•a Multi-Voice for Watson board - S99 
^ Multi-Fax for Intel SatisFAXtion (all models) 

and other CAS compatible boards - $199 
s Multi-Tasking Integrated (DESQview version 

option available - $99) 

All Library Source Code Included 
^ Many Example Programs 



iTI 



ITI Software 



Phone: 514-835-3124 
Fax: 514-835-4772 
BBS (demos): 514-835-5945 
Fax-On-Demand: 514-835-2216 



TRANSLATORS 

MASM ASM/86 
COBOL 



PL/I 



PL/M 



to "C" 



•Versions for PLM51, 80, 86, 96, 286, 386 

• Versons for most Cobol & PL/1 dialects 

• Generates "C" source and listing files 

• Rags errors; outputs equivalent "C" 

• MS-DOS 3.1 + ; protected mode option 

• Easy to use; includes User's Guide 

• From $475 ea. plus s/h; update service 

• Custom translation services available 



Micro-Processor Services, Inc. 

92 Stone Hurst Lane rry. 
Dix Hills, New York 1 1746 USA 111 
(516) 499 - 4461 ; Fax: (516) 499 - 4727 




1. Create fantastic prompts 
and save time with 
VFEdit®\ Record, crop, cut, 
copy, paste, mix, fade, echo, 
volume & more with your 
Dialogic™ D4x/12x boards. 

2. Add Voice Mail power to 
your MS Windows apps with 
TI/FDLL™, our Tel I/F 
Dynamic Link Library. 

3. Audio ToolBox™ 
converts to and from 



Professional 
Tools for 
your Voice 
Mail, Fax & 
Audiotex 

Applications 



Multimedia Wave (16, 8 & 
MS ADPCM), linear 16 & 
unsigned 8, plus Dialogic 4 
& 8 at any sample rate! 

4. Scribe Transcription 
Utility for DOS plays digital 
audio files in the background 
without voice mail hardware! 

5. Add Text-to-Speech 
capability to your apps with 
VoxFonts ™, our "software 
only" text-to-speech library! 



Order Now: 1-800-234-VISI 



Voice Infoimation Systems: 24 N Merion Ave, Biyn Mawr, Pa 19010 
Tel: 2 ] 5-747-5035/ BBS: 2 15-747-5062/ Fax i-800-234-FXtT 
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Opt-Tech Sort/Merge 



^ New -Version 5 

High performance Sort/Merge/Select 
utility. Run as a stand alone 
utility or CALL as a subroutine. 

Supports most languages and 

filetypes including Btrieve 
and dBase. Unlimited filesizes 
multiple keys and much more. 

MS-DOS, Windows $149 
OS/2, UNIX $249 

Call to order or for free info. 



Opt-Tech Data Processing 

P.O. Box 678 
Zephyr Cove, NV 89448 

(702) 588-3737 J 
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Why Can't Documenting 
Software be as Easy as 
Writing It! 

It Can be by Using 

BOCS 

The only CASE Tool giving you the 
freedom and ease you've grown 
accustomed to when it comes to coding. 
□ Inheritance 

□ Consistency Checking 
□ Automatic Document Generation 

□ "Pretty Printing" 

□ System Level Features 

And Lots More 
Put an end to documentation drudgery! 

Only $595 
Call for a demo copy 
Call 301-417-9884 or Fax 301-417-0021. 

Berard Software Engineering, Inc. 
902 Wind River Ln., Suite 203 
Gaithersburg, MD 20878 
Email: info@bse.com 
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If anybody knows how to do this rationally, 
stop me before I code again! The crude strategy 
here is to keep getting buffers, and if they're no 
good — won't do DMA because they cross a 
physical boundary — retain the offending part 
of the buffer and keep trying; and then when 
we get a good one, free all the chunks accumu- 
lated along the way. This approach relies on to- 
tally unreliable assumptions about memory allo- 
cation, and really comes down to a "keep trying 
until you give up" approach. 

Operating systems in 80x86 land get to own 
low memory, where it is relatively easy to set- 
up a good DMA buffer. Programs, on the other 
hand, can be loaded at any address, and can't 
make any such arrangements except, as far as I 
can figure out, by using awful things like the 
example. 

And incidentally, who owns the VDS (Vir- 
tual DMA Services) interface mentioned in the 
article? I have a vague idea how one goes about 
getting in touch with DPMI; is VDS one of 
these things that comes with DOS extenders 
and/or Windows or what? 

j.g. owen 
Software engineer 
31 Darby Drive 
South Huntington, NY 1 1746 
cis 71121,625 



Listing 2 Attempts to allocate 
a real-mode DMA buffer 



#def1ne BYTE char 
typedef unsigned int WORD; 
typedef unsigned long BIG; 

tfdefine JUNKCHUNK (128) 

/* how we will search for physical 

boundaries. (Must be >= sizeof (JUNK)) 



/* produce a big physical address. This 
is "large" mode code; " FP_SEG" etc. 
are 

Turbo C macros which extract the two 
parts of an 80x86-style segment-offset 
pointer. */ 

♦define PHYSICAL(x) ((BIG)((((BIG) 

(FP_SEG(x)))«4)+((BIG)FP_0FF(x)))) 

typedef struct JK 
struct JK *next; 
) JUNK; 

_f void *mustallocdma(W0RD size) { 
BYTE *a; 

JUNK root, *next, *p; 
BIG leftover; 
WORD junksize; 
root.next=NULL; 
next=&root; 

while(l) { 
a=mustalloc(size); 
/* mustalloc==malloc, 
but aborts if failure; 
the function exits this 
way or via the break below 
at success.*/ 




Programmer's 
Market 



Development 
Utilities 



World's largest/best indexed collections of techni- 
cal shareware extensively indexed and updated six 
times a year on CD-ROM or diskettes. 30 day 
guarantee. Creditcards. Ship/H $5US, $20Foreign. 



Products 



Access 
Assembler 
AutoCAD 
C (Turbo & MS) 
C++ (subset of above) 
dBase & Compilers 
Turbo Pascal 
Paradox 
Visual BASIC 
ObjectVision 
Netware 

PC Products Database 
TrueType Fonts 
Windows Professional 
Any/All of above on 2 



1.44 Disks/Files Price 



12/251 
12/431 
17/969 
48/1090 
21/435 
65/3307 
22/791 
17/620 
22/625 
3/100 
72/1176 



$59.50 
$59.50 

$149.00 
$59.50 

$149.00 
$59.50 
$59.50 
$59.50 
$29.50 

$149.00 



137,000 records $25.00 
15/752 $59.50 
62/820 $149.00 
CD-ROMs $59.50/$195 



EMS Professional Shareware 
4505 Buckhurst Ct; Olney, MD 20832 
(301) 924-3594, Fax: (301) 963-2708 
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Wh ere wou Id H ansel 
and Gretel be without 
a fopcst? 

Onlij You Can Prevent fbpesl Fires. 



I St A I cml Sunk) MH '|' ur 5fcfA tiKtlir. 



Neural Network 
Toolkit 

Neural network development software 
for serious applications or for learning: 

Backpropagation 

Self-organizing nets 

Graphical/batch shells 

C source included 

Ready to run samples, tools 

(3 No royalties 

Companion $20 Toolkit $40 
InfiNet $89 

Software Frontiers 
Systems, inc. 

P.O.Box 8524, Mesa.AZ 85214 

1-800-475-9082 Voice/Fax 602-985-8550 




DIG3.5forWindows 



BC & NT 



Works with Visual C + 

NO ROYALTIES 
FULL SOURCE 
ALL for $499.00 

WAKE UP to the possibilities 
ot advanced scientific 
graphics in your own 
software. Save years of 
programming time and 
effort. 

Get full source code for 
advanced graphics without 
paying any royalties. Do not 
get in the position of 
negotiating royalties after 
spending the time to learn 
and incorporate a graphics 
library into your program. 
Get powerful and robust source code that is easy to understand and 
modify Write to any windows device context, including windows, 
printers, icons, bitmaps and metafiles Copy metafiles and bitmap 
graphics to the windows clip board for export to other applications. 

Get all the advanced graphics that you want: xy. error. Smith, bar 
and pie charts. Get solid or wireframe surfaces with color coded 
height and solid or labeled line contours, even contours on spheres! 

Call (619) 632-951 & Order It. 




CHIRP Ml 



cal 

c e s 

C A 9 2 14 



The Only Optical Form Recognition 

Form Scan 



Recognizing: 

Text: Position, Point size and Attribute 
Line, Box: Position, Length and Weight 
Field: Position, size, Left or Right 
alignment for filled-in data 

Output: All out application to display 
and fill (with source) and formats in: 

• C: Make file, source file 

definition file, header file 
and resource file 

• Visual Basic: Form description 

file and project file 

• Jetform and others 



E-Data Link: (713) 690-5710 
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Source Code Generating Graphics Editor 



Spare yourself the tedium of programming 
graphics. Use Drawbridge to create: 
• logos, 

■ screen prototypes, 

■ graphics, 

■ animations, 

■ demonstrations, and 

■ instructional applications. 
Includes support for Borland BGI, Genus 
GX, MetaWindow, and Microsoft graphics 
libraries. 30-day money back guarantee. 
Demonstration disk available. 




I Courseware Applications 

One Appletree Square, Suite 989 ■ Bloomington, MN 55425 
Tel: (612) 854-8909 ■ Fax:(612)854-1868 
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NETWORKING 
PROTOCOLS 

♦ TCP ♦ ISDN 

♦ X.25 ♦ Frame Relay* 

♦ OSI ♦ ATM* 

♦ Portable STREAMS-based 
protocol stacks 

♦ All software written in C 

♦ Full support, training, porting 
and consultancy services 

♦ Source code licensed to more 
than 80 OEMs and Systems 
Integrators 

Spider Software 

For Further Information 
call us now on: 

Tel: 415-546-0606 or B\X: 415-543-5611 
Tel: 508-460-0049 or FAX: 508-460-0107 

("Available during 1994) 



Caromu:: 
tines 



Co-processor 
Card 



X.25 LAP-B HDLC SDLC 
Bisync & Custom Protocols 

Team up with Quadron's C-language develop- 
ment environment to offload communications to 
IBM's ARTIC tealtime co-processor cards. 

We'll supply OS/2 ot DOS services & tools to 
write multi-tasking applications for your system 
unit and cards. Development time is short 
because we handle low-level ARTIC code for you. 
You'll use standard compilers and C library 
functions, and debug quickly with our realtime 
symbolic debugger & statistics monitor. Call now. 



4fc 



Qliadron 805-966 6424 

209 East Victoria Street. Santa Barbara, CA 93 1 1 
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C PROGRAMMERS: 
BRIGHTEN YOUR FUTURE! 



Positions available in all phases of product 
development working for a leader in the 
LAN Enhancement Software Industry. 
C/C++ programmers needed to develop 
NetWare NLMs and Protocols. We offer: 

• Excellent Starting Salary 

• Full Benefit Package w/ 401 K 

• Flexible Hours 

• Central New Jersey Shore Location 

Please call or send resume today to 
Michael Randazza 
Brightwork Development, Inc. 
Jerral Center West 
766 Shrewsbury Ave. 
Tinton Falls, NJ 07724 
908-530-0440 x4523 

908-530-0622 fax BRIGHTWORK 



DICE IS LOOKING FOR. 



...data processing, engineering and 
technical writing professionals to fill 
open positions nationwide. DICE is 
a FREE online job search service 
providing detailed information about 
current contract and full-time 
positions across the USA. It's a 
confidential, easy to use, no cost 
way to search for a new job. 



DATA PROCESSING 
I NDEPENDENT 
CONSULTANT'S 
E XCHANGE 

ONLINE Number 
515-280-3423 




Contact DICE via 1200/14400 baud 
Modem, 8-N-1. 
A service of D&L Online, Inc. 
515-280-1144 
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BAS_C 

BASIC to C translator 

• inputs BASICA. Quick BASIC 

• outputs MS/guick/Turbo C [++] 

• CUSTOMIZER™ for other BASIC 

• restructures any spaghetti code 

• indented, scoped, modulized C 

• syntax error free, portable C 

• runtime library written in C 

• run on MSDOS, XENIX, UNIX 

• 1,000 copies sold since 1986 

• FREE DEMO DISK, INFO 

• Call for non MSBasic 

Starting from $599 

Gotoless Conversion 

7105 Dee Cole Drive, The Colony, TX 75056 

Phone (214) 625-2323 
Fax: 214-370-2612 BBS: 214-625-6905 
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The 
(treasure 

HUNTERS 

In the world of software, it is 
all too easy to lose a valuable 
treasure: by editing and saving 
a program, overwriting a vital 
previous version. 
To prevent you from having to 
search in vain for buried treasures. 
ARIS VERSION TRACKING SYSTEM 
for Windows enables you to access 
and use previous program versions, 

AVTS. A gem of a program 
at a diamond price. 



p> ARIS 

■C/> Information-Systems 



Parkstr.2, 85646 Anzing, Germany 
Phone +49-8121-45624. Fax +49-8121-45625 1 

From the USA, call 

Phone 01149-8121-45624 
, Fax 01149-8121-45625 
I Email: CompuServe 100042.1707 
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FINITE cOfX 

• OFF -K J, 



STATE 



TWO SPEED 
MOTOR 



CASE Compiler 

The COMPEDITOR, a CASE software 
development tool, quickly forms and 
documents event driven finite state, au- 
tomatons, and decision table programs. 
Forms state tables (to 11K cells) and 
the program's 'C source code. 

Determine what the program should do 
when the conditions represented by a 
state table cell occur. Enter in the cell 
the code or function(s) to call and the 
program's next state. Price $300 

Send for our free Tutorial 

AYECO, Inc. (407) 295-0930 

5025 Nassau Circ, Orlando, FL 32808 



C and C++ DOCUMENTATION 



! AUTOMATED DOCUMENTATION ! 

C-CALL ($69) Graphic-tree of caller/called 
functions, cross-ref, file/function index. 

C-CMT ($69) Creates/inserts/updates 
comment-blocks for each function, listing 
the functions and identifiers used by it. 

C-METRIC ($59) Counts path complexity, 
counts comments, code, 'C statements. 

C-LIST ($69) Lists and action-diagrams, 
or reformats into standard formats. 

C-REF ($59) Creates cross-reference of 
local/global/define/parameter identifiers. 

SPECIAL : C-DOC ($199) All 5 programs 
integrated as DOS program (<1 5,000 lines) 

NEW! C-DOC Professional ($299) 

DOS, OS/2, Windows. 3-ring binder/case. 
Processes 150,000 lines, deterred reports. 
• 30-DAY Money-back guarantee CALL NOW 
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SOFTWARE BLACKSMITHS INC. 

6064 St Ives Way, Mississauga 
ONT, Canada Voice/Fax en5>858-446 
L5N-4M1 Demos/BBS r" 



see AD INDEX for our larger ad 
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To the Editor: 

Concerning the letter from Lawrence H. Hardy 
in the 11.12 issue of CUJ, page 136, asking for 
information about PCX graphics: 

And I thought my memory was going... Ac- 
tually, this might instead be seen as an illustra- 
tion of the need for a CUJ index — depending 
on one's perspective of course. At any rate, whilst 
fumbling through a stack of old Journals seek- 
ing edification on a particular coding problem, I 
came across Vol. 9, No. 8 (August, 1991). Em- 
blazoned across the cover was "PCX GRAPH- 
ICS DOCUMENTED!" And sure enough, there 
on page 89 was a decent discussion of the topic 
by one Ian Ashdown, complete with bibliography. 

I would also like to join Ian Somerton (p. 
127) in expressing concern, if not alarm, at the 
exponential increase in C++ coverage of late. 
Perhaps someone on your staff misread it as C**? 

Sincerely, 

Scott Swanson 
Box 75 
Pendroy MT 59467 

/ am notorious within R&D for my instant 
amnesia, once an issue goes out the door. 
You're right that an index to CUJ is indispensa- 
ble, and the folks back in Kansas have antici- 
pated your wish. As for C++ coverage, that 
happens to be an area of intense interest in our 
community at the moment. We haven't forgotten 
about C by any means, but the mix what we 
publish is strongly influenced by the mix of 
what's proposed to us in the way of articles. — 
Pjp 




if ( 

(leftover=(PHYSICAL(a) & Bxffff)) + 
((BIG) size) 
>= 0x10900) { 

/* it's no good. */ 

if ( 

(junksize = 8x10000-1 eftover) 
< JUNKCHUNK) 
junksize=JUNKCHUNK; 
/* avoid endless 
teeny-tiny manipulations. */ 

free(a) ; 

next->next=mustalloc( junksize); 
next=next->next; 

} 

else 

break; /* success! */ 

) 

/* free debris. */ 
next= root. next; 
while(next) 
p=next; 

next=next->next; 

free(p); 

) 

return a; 

} 

/* End of File */ 




Programmer's 
Market 



REAL TIME 
Multi-Tasking Operating System 



• Task Manager 

• Queue Manager 
" U ART Manager 

' Resource & Semaphore 
Manager 

• ROMable 

• User Configure-able 

• All CMX Functions 
Contained in a Library 

• Preemptive Scheduling 



• Event Manager 

• Cyclic Timers Manager 

• Message Manager 

• Memory Manager 

• Supports Nested Interrupts 

• All Functions Written in "C 
for Portability 

• Task Scheduler& Interrupt 
Handler in Assembly for 
Speed and Optimization 



The NEW CMX-TINY is also Available 



ST9 Family 


7700 


80C166/167 


78K2/K3 


8051 and Derivatives 


8096/196 


H8/3XX, H8/5XX 


68HC11/16 


Other Microprocessors 


Z80/64180 



Source Code No Royalties 

GVIX s ° 8 - 872 - 767s 

Company FAX: 508-620-6828 
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Science and Engineering 
Libraries for C, C++, Pascal, 
and Windows 



G_MATH 3.1: Interactive Math, Real & Complex 
Roots, Integration, Interpolation, Matrix, Curve 
Fitting, graphics, & more. $149. 

G_FFT3.1: Interactive Signal Processing, Real, 
complex FFT, Correlation, Convolution, Power 
Spectrum, Filter Design, Graphics, & more. 
$149. 

G_FFT 3.1: Class Library. $149 

OOPIot: Interactive Scientific plotting, Linear, 
Log, LogLog, Scatter, Bar, Pie graph, grids, 
Origin setting, overlapping windows, & more. 
$149. Class Library: $149. 

OOParser Class Library, Expression and 
function evaluator with 1 , 2, & 3 variables and 
unlimited parameters. $79 

30-day money back. No Royalties. Free Technical Support. 

Sigma Software 

15779 Columbia Pike, suite 360 
Burtonsville, MD 20866 

Call or Fax your order to 
301-317-6207 



Developers: 

For the next couple of months we will be telling 
you about a new set of shareware utilities called: 

VSST: Valois Software System Toolkit 
This month we are featuring VHDISK: 
» Identifies IDE drive manufacturer & model 
» Lists bad sectors not listed in DOS FAT, and 
how many spare sectors left before data loss 
» Modify cache/error configuration settings 
» Performs many seek and data transfer tests 
» Allows power control over spindle motor 

Unlike other utility packages, VSST can be run 
in batch mode, not only displays but saves the 
information to disk so that it can be used later 
for reporting/comparison with other systems, and 
comes with .LIB files: link with your code! 

Call Toil-Free: 1-800-884-SOFT 

Valois Software Inc. 

2237 Cecilia Ave. San Francisco, CA 94116 
Fax: (415) 759-0948 CIS: 71117,1762 
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A F uzz^ Logic 
™ Designer* 

The tool to use for applied fuzzy logic, 
not hazy theories 

Now with neural rule weights 




s for generated output 
6r information today. 
t and DLL capability available 

Byte Dynamics, Ini 

14608 E. Olympic Ave. 
Spokane, Wa. 99216 

Call: (800) 233-2983 
Fax: (509) 926-6130 

* Custom software development available 
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PostScript From C! 



c_pslib 

/ Complete Set of Gra 
/Text Functions for fi 
/Downloadable Fonl 
/ Encapsulated Posl 



^c^psFontlnto 

/St-ngwatn Calculations 
✓ FonfRoepcoding 
/Kerning,,' 




Site License each 
Single User License $ 1 95 each 
ANSI and K&R Source Code Included 

C_ Graph Software Inc. 
P.O. Box 5641 Austin, TX 78763 
512-444-3336 
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C, C++ and BASIC programmers, 
now you get much more than 
xBase compatible DBMS power. 



m housands of programmers have 
already discovered how to get dBASE, 
FoxPro and Clipper compatibility from 
their favorite language and hardware 
platform. For example, one customer 
has C programs running on PC and Sun 
workstations sharing data with 
concurrently running FoxPro for 
Windows applications. You see, 
CodeBase technology is simply the best 
way to add multi-user xBase compatible 
DBMS power to C, C++, or BASIC. 

You still get high speed & small size 

CodeBase users really appreciate our 
small executable size. Unlike SQL 
engines which are a Meg or so in size, 
CodeBase 5.1 EXE's can be as small as 
45K! You'll also like the speed-with 
our Intelligent Queries you get the 
execution speed of C plus stunning 
query performance from our smart use 
of available index information. 

Introducing CodeControls 

Now formatted data entry in Windows is as easy 
as point & click! 



Product: f'WId flt BVahngs l 

Product Code: BbS-324'55 ) 
Description: wugM Bcwtaga are 

("od'JfTton at faohti. 





Buffer Wrench 
Dunsel Joints 

Greshmats 
Widglt 

WMq* Sellings 



Units Stocked 
CostyUntt t~ 
List Price f™ 
Stock Value 
units Ordered j 
Total Cost r 



$49.00 
WjSOO^OOj 



3000] 

5147,000.00; 



I H I * 1 ^. I > I H leg=l rS I Date Ordered [March 14 / 1M3 



1 



Introducing the new CodeControls, a unique set 
of data-aware custom controls. Now simply drop 
them into your Windows applications via your 
favorite visual interface builder. 



NEW-You get formatted data entry 
Experienced Windows programmers 
know formatted data entry is difficult 



to program under Windows. But with 
our new CodeControls, you can simply 
'Point & Click' to design data entry 
windows for date, numeric, and character 
information-formatted just the way you 
want it. 

NEW-Data-aware controls 

Our custom controls are data-aware, so 
now you can easily build a scrolling list 
box that's tied to a data file, or look up 
matching combo box entries-even as the 
user types. 

Introducing CodeReporter 2.0 

Now use the new Instant Report Wizard to create 
a variety of reports— instantly. 




Introducing the new CodeReporter 2.0. our inter- 
active xBase report writer. We designed it with 
developers in mind, but end-users will love it. 



NEW-You get instant reports 

Use our new Instant Report Wizard to 
quickly create a wide variety of 
reports-in an instant, then easily refine 
them as necessary, or let your end users 
build their own special reports! 

NEW-You get drag & drop 

We've added drag & drop capabilities to 
CodeReporter, so regardless of whether 
you want data, totals, or text, simply drop 
a report object onto your layout screen. 



NEW-You get interactive queries, 
sorts, & relations 

Use CodeReporter to 
visually design reports 
easier than ever. For 
example, you can 
quickly build query and sort 
expressions using our calculator-style 
expression builder. In addition, you can 
easily relate data files together using 
our graphical relation builder. 





"There's never been a better time to buy 
into CodeBase technology. You get 
complete xBase compatibility, full 
DBMS power, plus an interactive report 
writer and a set of unique data-aware 
custom controls for Windows." 
-Ken Sawyer, President, Sequiter Software 

Buy One, 
Get Two FREE. 

Now when you buy any one of our xBase 
library products: CodeBasic, CodeBase++, 
or CodeBase ( for the language of your choice), 
you'll get both the new CodeReporter 2.0 
AND the new CodeControls absolutely 
FREE-for a limited time only. 

To Order Now Call 
403-437-2410 

Unconditional 90-Day Money-Back Guarantee 

SEQUITER 



SOFTWARE INC. 



FAX 403«436«2999 
UK Tel. +44-81-317-4321 
France +33.20.24.20.14 



®1993Seqjfrer Software. Inc All rights reserved CodeBase. CodeBase++. CodeBasic, CodeReporter c 



P.O. Box 575 Newmarkel NH 03857-0575 

s trademarks of Sequiter Software Inc. All other product names mentioned herein are trademarks of their respective companies 
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FAST, PORTABLE C DEVELOPMENT TOOLS 



y Client/Server 

>/ Proven Performers 

v Develop Royalty-free 
with c-tree ^_ 




v Unsurpassed Portability 

■/ Source Code 

✓ Customizable 

y Powerful Report 
Generation 




Lightweight Solutions lack features 
and flexibility you may need 



Heavyweight Solutions will cost 
a small fortune before 



FairCom® Offers A Full Line Of High-Performance Servers 
& Development Tools At Reasonable Prices. 



FairCom Servers® 

SQL & non-SQL 

These multi-threaded database servers 
offer a seldom-found solution for developers 
who demand control. While one may 
mandate SQL access, another's real-time 
demands may not tolerate the overhead 
associated with SQL. Our unique servers 
offer the full range of data accessibility: 
low-level speed; convenient ISAM-level; 
compatible SQL-level. Complete data 
integrity is achieved with multi-user 
transaction processing. Recovery of all 
committed transactions after a failure is fully 
automatic. The C developers 
'CLIENT/SERVER' solution: DOS nodes to 
UNIX servers; full commit and rollback; roll 
forward; precise control over your data 
and/or data base model; large files (4GB); 
complete client source code. On-line data 
backups with maximum data availability and 
protection. These servers are designed to 
achieve maximum power and flexibility 
without sacrificing control. 

r-tree® 

Report Generator 

r-tree report generator provides complex, 
multi-line reports by virtually handling 
every aspect of report generation. Your 
only programming requirement is to call 
the r-tree report function, which reads 
c-tree data files, performs calculations, 
monitors control breaks and 
accumulators and produces a formatted 
report. 



c-tree Plus® 

High Performance Data Management 

Based on the most advanced B+ Tree 
routines available today, c-tree Plus gives 
you unprecedented control over your file 
management needs. With unparalleled 
sophistication, c-tree Plus has established 
itself as the premier choice for commercial 
development. Use the low-level routines or 
take advantage of the high-level ISAM 
routines for high speed random or 
sequential access, c-tree Plus is distributed 
in complete C source code and is known 
for its portability and royalty-free licensing 
policy. Whether for single-user, multi-user or 
client-side application development, c-tree 
Plus delivers. Transaction processing is 
included in c-tree Plus as well as features 
like: fixed/variable length records and keys; 
dynamic space reclamation; high speed 
hashed data and index caching (and 
savepoints, abort, and rollback); full ISAM 
functionality; and batch operations. All 
functions are fully ANSI prototyped. Call for 
a complete list of features. 



d-tree Toolbox® 

Application Development 

Productivity tools with: a complete 
portable screen handler; data 
dictionary; code generation; easy to 
use data base interface; menus; help 
text; data validation, d-tree's dynamics 
allow runtime control of program 
resources (screens, files, edits, etc.) 
not found in any other development 
package. Resources can be changed 
in memory, and/or swapped on/off of 
disk at runtime. Additional productive 
features include: flexible data 
windows; field masks; user-defined 
and field-level edits and data file 
reformatting. If you do application 
development on multiple platforms 
(DOS/UNIX), or you're debating 4GL 
versus C development, d-tree is for 
you. 



Natural Query™ 

Natural Language Tool 

Produces ad hoc reports quickly and easily 
from English sentences. It is the first 
low-cost, natural language tool designed for 
developers and a broad range of users. The 
QBE option has easy-to-use, pick and 
choose menus, making report specifications a 
snap. Available in VAR or end-user versions. 
❖ Request 128 on Reader Service Card ■> 
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Call today for more information: 

(800) 234-8180 

FAIRCOM® 
corporation 



4006 W. Broadway . Columbia, MO 65203 
(314) 445-6833 Fax (314) 445-9698 

FAIRCOM EUROPE 
Via Sottocorna 15/17 ■ ALBINO (BG) ITALY 
tel. 035/773464 ■ FAX 035/773806 



